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About This Publication 


This publication describes how to use the Page Printer Formatting Aid (PPFA) to create and compile page 
definitions and form definitions for printing or viewing files with Advanced Function Presentation products, 
such as IBM Print Services Facility. 


Who Should Use This Publication? 


This publication is for anyone who wants to use PPFA to create form definitions and page definitions 
(traditional and record format). This publication has been written assuming that you are one of the 
following: 


° A first-time user 


You are using PPFA for the first time to create form definitions and page definitions. You are familiar 
with system commands, but you are not familiar with Print Services Facility (PSF) concepts and Page 
Printer Formatting Aid parameters. You should read all of the information contained in this publication, 
and then use it as a reference. 


For more information about Advanced Function Presentation concepts, refer to Guide to Advanced 
Function Presentation. 


For more information about AIX concepts, refer to /BM Print Services Facility for AIX: AlX for Users of 
Print Services Facility. 


For more information about OS/400 concepts, refer to OS/400 User’s Guide. 


For more information about VSE, MVS, VM, or OS/400, refer to the Application Programming Guide for 
the platform you are using. 


e An intermediate user 


You are familiar with print server concepts and with Page Printer Formatting Aid parameters and you 
know the difference between a logical page and a physical page. You already know how to create and 
use form definitions and page definitions. Use this publication as a reference to learn more about PPFA 
commands and syntax. Refer to the examples for useful information. 


e An advanced user 


You understand print server concepts and have used PPFA to create form definitions and page 
definitions. You understand the use of data stream processing. You will use this publication mostly as a 


reference. |Chapter 5, “Creating Complex Printouts”| might be especially helpful. 


Note: Not all of the functions provided by PPFA are supported in all print server licensed programs. Refer 
to the information for the print server licensed program that you are using to determine which 


functions are supported. For more information about a specific environment, see|Appendix A, 
“System Dependencies for PPFA”|for the steps required to process page definitions and form 


definitions. 


How This Publication Is Organized 


You can use this publication both as a guide and as a reference to help you learn about the following: 


¢ |Chapter 1, “Introducing Page Printer Formatting Aid”|summarizes PPFA and describes the purpose of 


form definitions and page definitions. Key PPFA concepts and terms are defined in this section. 


¢ |Chapter 2, “Using Form Definition Commands’”| shows examples illustrating the use of basic 


form-definition controls for traditional line data. 


¢ |Chapter 3, “Using Page Definition Commands for Traditional Line Data”} shows examples illustrating the 


use of basic page-definition controls. 


¢ |Chapter 4, “Using Page Definition Commands for Record Format Line Data and XML Data”| shows 


examples illustrating the use of basic form-definition controls for record format line data. 
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¢ |Chapter 5, “Creating Complex Printouts”| shows examples of print jobs that require advanced use of 


form-definition and page-definition controls. 


* |Chapter 6, “Conditional Processing”|shows examples of conditional processing used in formatting 
complex printing applications. 


* |Chapter 7, “N_UP Printing”|describes how you can use N_UP printing. 
¢ |Chapter 8, “PPFA Command Syntax’| defines the rules and the syntax for writing a set of PPFA 


commands. 
* defines all the PPFA form-definition commands, their subcommands, and their parameters. 


¢ |Chapter 10, “Page Definition Command Reference (Traditional)”|defines all the PPFA traditional 
page-definition commands, their subcommands, and their parameters. 


* |Chapter 11, “Page Definition Command Reference (Record Formatting and XML)”|defines all the PPFA 


record format page-definition commands, their subcommands, and their parameters. 


¢ |Appendix A, “System Dependencies for PPFA”| shows the steps needed to create and use form 


definitions and page definitions in VSE, MVS, VM, AIX, and OS/400 systems. 


* Appendix B, “More about Direction”| expands on the direction information and includes a lookup table. 
* |Appendix C, “Differences in Measurements and REPEATs with AFP Utilities”| describes the differences 


in printing with measurements and REPEATs between PPFA, OGL, and PMF. 


° [Appendix D, “More About Bar Code Parameters’| contains supplemental information about bar codes. 
° [Appendix E, “PPFA Keywords’| contains lists of PPFA symbols and keywords. 

° [Appendix F, “PPFA Media Names’|contains a list of media names, types, and component identifiers. 
° [Appendix G, “Fill Patterns for DRAWGRAPHIC Commands’ |contains examples of fill patterns for the 


DRAWGRAPHIC commands. 


¢ |Appendix H, “PPFA Messages and Codes” lists all diagnostic messages generated by PPFA and 
suggests a cause and solution for each. 


Notices to include trademarks, a glossary of terms, a bibliography, and an index are included at the back 
of the publication. 


Reading Syntax Diagrams 


The syntax for PPFA commands is shown using graphic notation. To read the diagrams, move from left to 
right and top to bottom, following the main path line. 


Style Rules: 
Syntax diagrams use the following style rules to show how to enter commands and parameters: 


* A word in uppercase must be spelled exactly as shown, but may be coded in any case. For example in 
coding, FORMDEF or FormDef or formdef are equivalant. 


¢ A word in all italic, lowercase letters shows a parameter that you can replace. For example: 
name 
shows that you replace name with a resource name that is retained in the library. 


¢ A parameter above the line shows the default parameter. For example, SBCS is the default parameter 
in the syntax diagram for the FONT command: 


SBCS 
>>—FONT— .. 3 >< 
_DBCS— 
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Symbols: 
Syntax diagrams use symbols to help you follow the flow of information they communicate: 
¢ Statements begin with: 
>> 
* and end with: 
>< 
¢ Statements longer than one line contine to a second line with: 
“5 
* Where they resume with: 


>— 


Required Parameters: 


A parameter that you must include is displayed on the main path line. For example, the syntax diagram for 
the SEGMENT commana: 


>>—SEGMENT—name—3 >< 


shows that you must follow SEGMENT with its required parameter. 


If there are two or more required parameters from which to choose, the parameters are shown with the 
first choice on the main path line and the other choices on branch lines under it. For example, the partial 
syntax diagram for the DIRECTION Command: 


>>—DIRECTION ACROSS >< 
DOWN 
t-BACK——+ 
L_jp——— 


shows that you must type the command in any of the following ways: 
* DIRECTION ACROSS 

* DIRECTION DOWN 

* DIRECTION BACK 

¢ DIRECTION UP 


Optional Parameters: 


Parameters that you can include with a command are displayed on the branch line below the main path 
line. For example, the partial syntax diagram for the COPYGROUP command: 


--CUTSHEET - NO— 
>>—COPYGROUP—name mr 
L-CUTSHEET - YES— 


shows you can type the command in one of these ways: 
* COPYGROUP name1 CUTSHEET YES ; 
* COPYGROUP namei CUTSHEET NO ; 
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¢ COPYGROUP name?7; 


Branch lines can include branch lines of their own. An example of this is the partial syntax diagram for the 
SUBGROUP command with the optional BIN parameter: 


BIN—1 
>>— SUBGROUP > 


BIN n 
-wawua.— 
'_ENVELOPE 


Repeating Parameters: 


An arrow on a line above a parameter means that you can either repeat the parameter or enter more than 
one of the listed parameters. An example of this is the partial syntax diagram for the SUPPRESSION 
subcommand in the SUBGROUP command: 


>>—SUPPRESSION—*—name >< 


The arrow above name means you can include one or more field name parameters with the 
SUPPRESSION command. 


Fragment Elements 


A syntax diagram can contain a section that either has too many items or groups to fit in the diagram or is 
used more than once. This section can be presented as a “fragment”, and given a label that corresponds 
to the section within the main diagram. An example of this is the syntax diagram for the FORMDEF 
subcommand with its fragmented OVERLAY subcommand shown below: 


Note: This FORMDEF diagram example also displays examples of some of the parameters mentioned 


above. 
FORMDEF 
INVOKE—SHEET: 
>P-. >< 
Ly up——1 L_INVOKE NEXT. 
2 ~ ron 
3 BACK: 
L4 


OVERLAY Subcommand I 


OVERLAY Subcommand: 
--OVROTATE—0: 
| OVERLAY—name 7 7 | 
x-pos - y-pos ‘PARTITION '_OVROTATE 90. 

180 
270 
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Related Information 


See the Bibliography section for lists of publications, by category, that may be helpful to you as you use 
PPFA. 


Publications that are referred to in this document or that contain additional information about Advanced 
Function Presentation (AFP), the MVS operating system, Print Services Facility (PSF), and related 
products and systems are listed in the Bibliography. 


The following is a listing of WEB sites that may be helpful to you as you use PPFA: 
¢ PPFA = http://www.ibm.com/printers/r5psc.nsf/web/ppfa 

¢ RS6000 and AIX = http://techsupport.services.ibm.com/server/support/ 

* Guide to IBM BookManager BookServer = http://rs3bt.cae.de.ibm.com/ 


About This Publication 


xxi 


Xxii = PPFA User’s Guide 


Summary Of Changes 


Summary of Changes for IBM Page Printer Formatting Aid: User’s Guide, $544-5284-06 


This publication contains additions and changes to information previously presented in IBM Page Printer 
Formatting Aid: User’s Guide, S544-5284-05. The technical additions and changes are marked with a 
revision bar (|) in the left margin. 


The following information is new or updated: 


¢ |Chapter 4, “Using Page Definition Commands for Record Format Line Data and XML Data” on page 59 
has the following changes: 


— Support for eXtensible Markup Language (XML) can be found in[*XML Page Definition Formatting] 
Function” on page 92 

— Support for additional finishing operations has been added to[‘*COPYGROUP Command” on| 
page 170 
Chapter 10, “Page Definition Command Reference (Traditional) on page 207) has the following changes: 

— Support has been added for two-dimensional barcodes in 

following changes: 

— Support has been added for eXtensible Markup Language (XML) 


— Support has been added for two-dimensional barcodes in|“FIELD Command (Record Format)” on 
page 285] and|“FIELD Command (XML)” on page 300) 


* The|“Index” on page 479|/has been rewritten to better reference commands, parameters, and variables. 
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Chapter 1. Introducing Page Printer Formatting Aid 


Page Printer Formatting Aid (PPFA) is an IBM licensed program that enables users of IBM’s Advanced 
Function Presentation (AFP) products to create their own formatting resources, called form definitions and 
page definitions. The form definitions and page definitions are stored in libraries’ as AFP resources. Using 
AFP resources requires IBM Print Services Facility (PSF) or Infoprint Manager, licensed programs or 
features, which merge resources with user data files. This merging creates a data stream for printing or 
viewing. 


Using a form definition or a page definition created by PPFA requires you to perform three steps: 

1. Write a set of PPFA commands that define how to position the data or handle the physical sheets. 

2. Run PPFA to build the specified page definition or form definition and store the output as resources in 
a library. 

3. Submit the print file using your print server, specifying the page definition and form definition needed to 
accomplish the desired results. 


Figure 1 on page 4) shows how form definition and page definition relate to PSF. In|Figure 1 on page 4} the 


area inside the broken line represents steps 1 and 2. The area outside of the broken line shows how PSF 
merges resources with the specified print job to form a single print stream and sends it to a page printer. 


1. For purposes of this book, the term “library” includes AIX directories as well as OS/390, VSE, and OS/400 libraries and VM files. 
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Application Data 


Unformatted ACIF 
ASCII Data * for AIX 


MO:DCA-P 
Data 
MVS, VM, VSE, OS/400 System 
S/370 Spool 
Mixed Data 
S/370 
Line Data 


AS/400 


Mixed Data Page Segment 


Directory 


AS/400 


Line Data Font 


Directory 


a Print AFP 
Overlay Services Printer 
Directory Facility 
Lt 


Page Definition 
Directory 


System 
Dependent 


Commands 
and 
PPFA Source 


Form Definition 


Directory 
Utility Resource Printer Hardware 
Libraries Driver 


* (not used by PSF/400) 
Figure 1. Form Definition and Page Definition Environment 


Note: is a general representation for operating systems that use PPFA. However, PSF users in 
the OS/400 environment do not use unformatted ASCII data. Also, PSF users in the OS/400, VSE, 
OS/390, and VM environments should substitute the word “Directory” for the system-specific file 
organization (for example, OS/390 library). 


Summary of a Form Definition 


A PPFA command stream can contain form-definition commands. A form definition specifies how the 
printer controls the processing of the physical sheets of paper. In a form definition, you can specify 
modifications that distinguish formatting one print job from another when both are derived from the same 
data. Form definitions are used for all print server print files regardless of data type. 


Form definitions can specify the following functions: 
* Position of a logical page on a physical page 
* Duplex printing 


4 PPFA User’s Guide 


¢ Inclusion of overlays, which substitute for preprinted forms 
¢ Flash (the use of a forms flash—only on 3800 printers) 
¢ Selection of the number of copies for any page of data 


¢ Suppression (the exclusion of selected fields of data in one printed version of a page of data but not in 
another) 


¢ Jog (the offset stacking of cut-sheet output or copy marking on continuous-forms output) 
¢ Selection among paper sources in a cut-sheet printer 

¢ Adjustment of the horizontal position of the print area on the sheet (only on 3800 printers) 
* Quality (selection among print quality levels) 

* Constant (allows front or back printing of a page without variable data) 

* Printing one, two, three, or four logical pages on a single side of a page 


¢ Postprocessing controls, such as: 
— Selecting functions 


Selecting device-dependent functions defined by the postprocessing device 
° Perforating 
* Cutting 


Summary of a Page Definition 

A page definition specifies how you want data positioned on the logical page. A page definition can control 
the following functions: 

¢ Dimensions of the logical page 

¢ Print direction of the logical page 

¢ Print direction of text lines and fields relative to the logical page 

* Conditional processing (different formats on different pages, based on content of data) 
* Text line spacing (number of lines per inch) 

¢ Location of individual text lines and fields 

¢ Number of text lines per page 

* Page segments for inclusion in printed output 

* Overlays for inclusion in printed output (positioned anywhere on the page) 

* Page-ejection points 

* Fonts and font rotation used on a page 

* Multiple-up printing (placing more than one subpage on one side of a single sheet) 

* Colors to be used (on printers that support this function) 


Formatting Output of Different Data File Types 


The_four basic types of data printed on the print server printers are: 
called AFPDS in OS/400) 


Unformatted ASCII files] (typically AIX) 
Line-data files, mixed-data files, and unformatted ASCII require a|page definition] and alform definition 


MO:DCA-P data files require only a form definition. 


Line-Data Files 


Line data is EBCDIC data that is arranged for printing on line printers. These records may contain 
line-printer control characters such as carriage control characters (CC or FCFC), table-reference 
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(TRC), or only data. To compose pages for the page printer from line data, the print servers 
separates the incoming print records into pages according to specifications in a page definition. A page 
definition is always required for printing line data with the print server. You can create your own page 
definition or use a page definition provided with the print server. There are two types of line data: 
traditional and record format. 


The line data input to the print server can consist of records that are fully formatted; it can consist of 
records that contain only the fields of data to be printed; or it can consist of records of both types. You can 
use the page definition resource to format fields of line data outside of the application program. Refer to 
Print Server Facility for OS/390 User’s Guide, Version 3, Release 2.0 for additional information. 


The following example shows two types of line data. The first type shows data arranged as it prints out 
and the second shows data that requires field processing. 


Formatted Print Records Print outputis same 
R/O|B/I|N/S/O\N) [E].| |C|R|U/S/O|E hAMEDEr 
1/2|3 I}S/L/A)N|D| |P)LJA;C\E with line 
K/E/Y| |WIE|S|T|, FIL 3} 3] 0} 4/0 \ 
UISIA formatting Robinson E. Crusoe 


123 Island Place 


Unformatted Print Records Key West, FL 33040 
+PAGEDEF 


USA 


Namefield | Streetfield | City,State | Zip} Country with field 


formatting 
Figure 2. Formatted / Unformatted Print Records 


The technique of mapping the unformatted data to locations on the output pages is known as field 
processing or record processing and is available through use of page-definition controls. Field processing 
is explained in detail in|/“Processing Fields” on page 45 


Traditional Line Data 

Traditional line data is data formatted for printing on a line printer. Fully formatted line data can be printed 
on a line printer without a page definition, however all line data needs a page definition to be printed on a 
page printer. 


A traditional line data record can contain a 1-byte carriage control character and a 1-byte table reference 


character followed by the data to be printed. (With a line printer, the maximum number of data bytes in a 
single input record is 208. With a page printer, the maximum number is 32,768 bytes). Refer to}Chapter 3, 


“Using Page Definition Commands for Traditional Line Data” on page 35}for additional information on using 


traditional line data. 


Record Format Line Data 


The record formatting function allows an application to specify a format identifier (record id) with each set 
of data fields (data record). The format identifier references a specific layout format in a Page Definition 
(PAGEDEF). At print time, each layout format (referenced by a record id in a data record) is retrieved from 
the PAGEDEF and used to position and format the associated data records/fields on the output page. The 
PAGEDEF can contain any number of layout formats. The application can use a PAGEDEF layout format 
to either insert an end of page when a specified last line point is exceeded on the output page or to force 


an end of page. Refer to}Chapter 4, “Using Page Definition Commands for Record Format Line Data and 
KML Data” on page 59] 


L Data” on page 59jon using record format line data. 
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statmid Justin Case 123 Sligo Lane Longmont CO 80501 


ckheader 

ckdata 352 01/04/02 $ 321.50 Golf, etc. 

ckdata 353 01/05/02 $ 100.00 Shorty's Pit Barbecue 
ckdata 354 01/10/02 $ 122.30 Tattered Cover Bookstore 
ckdata 355 01/11/02 $ 59.95 Kristina’s Pretty Things 
ckdata 356 01/15/02 $ 852.33 Pirie Racing Enterprises 
ckdata 357 01/30/02 $ 500.35 Warcup’s Music Center 
Ckend 


Figure 3. Example of Record Format Line Data 


Mixed-Data Files 


Mixed-data files consist of MO:DCA-P data and line data or unformatted ASCII data. Such files may or 
may not specify the beginning and ending of pages and may or may not contain page addresses and data 
controls for page printing. The line-data portion of such files must be formatted for page printers by 
page-definition controls. 


MO:DCA-P Data Files 


MO:DCA-P data files are formed into pages before the print server receives them. These files already 
contain the imbedded controls for printing on page printers. They contain such things as page addresses 
and data controls for page printing functions. 


Note: Refer to Mixed Object Document Content Architecture Reference, (SC31-6802) and Advanced 
Function Presentation Programming Guide and Line Data Reference, (S544-3884) for more 
information about MO:DCA-P data. User application programs can also generate MO:DCA-P data. 
In OS/400, MO:DCA-P print files are created automatically wnen DEVTYPE=AFPDS in the Printer 
File. 


Unformatted ASCII Files 


Unformatted ASCII files consist of ASCII data with no formatting controls (escape sequences) in the data. 


The technique of mapping the unformatted ASCII data to locations on the output pages is known as field 


processing or record processing and is available through use of page-definition controls. Field processing 
is explained in detail in|/“Processing Fields” on page 45 


Unformatted ASCII data differs from unformatted EBCDIC data in that ASCII data is what is generally 
created on a personal computer or workstation, while EBCDIC data is what is generally created on a 
mainframe host, such as OS/390, VM, or VSE, or on OS/400. 


PPFA Concepts 
The concepts of|physical page| |logical page} and are basic to understanding form-definition and 


page-definition controls. 
Physical Page 


A physical page is the sheet of paper or other medium (a sheet of labels, for instance) that moves through 
the printer. 


Logical Page 


A logical page is the area you define in a PPFA command stream as the space on the physical page 
where data is printed. The logical page is positioned in relation to the media origin. For more information 
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about the media origin of your printer, refer to your printer documentation or the /BM Printing Systems: 
Printer Information. The positioning of the logical page on the sheet of paper is described in 


Logical Page on a Sheet” on page 21 


An N_UP command enables you to place one, two, three, or four logical pages on a single sheet. This is 
in contrast to multiple up, which enables you to place subpages on one logical page. 


Subpage 

A subpage is a part of a logical page on which line data may be placed. Subpages are used only with 
conditional processing. Multiple-up printing can be done with or without subpages being defined. In the 
page definition, multiple subpages can be placed on the physical page based on changes in the print data. 


A good example of this is the use of multiple-up printing, which is printing two or four pages on a single 
side of a sheet. For more information, see |‘Subpage Description and Processing” on page 120 
PPFA Basic Terms 


The following terms have meanings that are special to PPFA: 


N_UP partitions 
Modifications 


Printline 


Printline is a single line of text, and is the traditional command that is synonymous with the record 
formatting Layout command. In the formatting of line data and unformatted ASCII, a printline is normally 
the output generated by one record in the print file. However, printlines and print records are not the same. 


PRINTLINE commands in the PPFA page definition define the number and position of printlines on a page. 
Each record in the print file is written to a single printline on a page. Usually, one print record is written to 
each printline. However, control information in the print data can specify two or more print records be 
written to the same printline, providing overprinting. Controls also can specify that print records skip 
printlines. For example, a print record may skip the remaining printlines on a page and print instead on the 
first printline of a new page. 


Layout 


Layout specifies a single line of text, and is the record formatting command that is synonymous with the 
traditional Printline command. In the formatting of line data and unformatted ASCII, a layout is normally the 
output generated by one record in the print file. However, layouts and print records are not the same. 


LAYOUT commands in the PPFA page definition define the number and position of layouts on a page. 
Each record in the print file is written to a single layout on a page. Usually, one print record is written to 
each layout. However, control information in the print data can specify two or more print records be written 
to the same layout, providing overprinting. Controls also can specify that print records skip layouts. For 
example, a print record may skip the remaining layouts on a page and print instead on the first layout of a 
new page. 


Direction 


Text can be printed in four print directions. A print direction is a combination of both inline and baseline 
directions. For each of the directions, characters can be printed in four rotations. 
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The line direction is the direction in which successive characters are added to a line of text. The four line 
directions are: 


ACROSS Text characters are placed in a line from left to right across the page. 
DOWN Text characters are placed in a line from top to bottom down the page. 
BACK Text characters are placed in a line from right to left across the page. 
UP Text characters are placed in a line from bottom to top up the page. 


The baseline direction is the direction in which successive lines of text are added to a page. The four 
character rotations, measured clockwise around each inline direction, for each line direction are: 


For example, the text in this paragraph is printed ACROSS the page, and its rotation is 0°. 


shows the four possible directions. For information about the combinations supported by the 
printer you are using, refer to /BM Printing Systems: Printer Information. 
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Figure 4. Baseline Direction and Inline Direction 


Rotation 


Individual characters can be rotated. Character rotation can be 0°, 90°, 180°, or 270° relative to the inline 
direction of the printline or field. 


Note: On the 3800 printers only, character rotation differs between bounded-box fonts and 


unboundea-box fonts. Bounded-box fonts rotate the fonts; unbounded-box fonts are rotated by 
selecting the correct font. 
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Presentation 


Presentation describes the shape of the page as it is viewed by the reader. shows an example of 
how text is presented (positioned) on the page. There are two page presentations—portrait and landscape. 


Portrait Is designed to be viewed with the short side at the top of the page. 


Landscape Is designed to be viewed with the long side at the top of the page. 


DocumentB - Landscape Presentation 


Figure 5. Portrait and Landscape Presentations 


N_UP Partitions 


Some printers allow the physical sheet of paper to be divided into equal-sized partitions. For two or three 
partitions, each sheet is divided along one or two lines equally spaced along the longer side of the sheet. 
The printer positions a logical page of print data in each partition. This enables printing multiple logical 
pages with different formats and modifications on a single sheet of paper. 


The size and arrangement of the partitions on the sheet depends on the number of partitions and the 
shape and size of the paper. For two or three partitions, each sheet is divided at two or three points 


equally spaced along the longer side of the sheet. For four partitions, each sheet is equally divided both 
vertically and horizontally. See |Chapter 7, “N_UP Printing” on page 141}for more information. 
Modifications 


Modifications are sets of form definition controls that apply to one page of a data file. With these controls, 
you can: 

* Define the type of duplex printing to be done 

* Define one, two, three, or four partitions for N_UP 

* Select an overlay 

¢ Suppress the appearance of a field 

* Select the forms flash option (only for the 3800 printer) 

¢ Specify the number of copies for a set of modifications 

* Specify post-printing processing options 


You can specify different sets of modifications for the same page of data in one form definition, and 
therefore in one print job, by a series of SUBGROUP] commands. For example, a form definition with two 
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SUBGROUP commands is said to have two sets of modifications. The same page of data is printed for 
each set of modifications, resulting in a slightly different output for each printing. 


Definitions of Command, Subcommand, and Parameter 


and are terms used throughout this publication to refer to the 
contents of PPFA control statements. |Chapter 9, “Form Definition Command Reference’ and |Chapter 10, 
“Page Definition Command Reference (Traditional)”| describe these commands with all their applicable 


subcommands. 


Commands 
Commands are the major controls composing form definitions and page definitions. 


Subcommands 


Subcommands are used to further define commands. The absence of subcommands means that the 
default values specified with those subcommands are used. Three command terms also appear as 
subcommand terms—FONT, OVERLAY, and SUPPRESSION. These subcommand terms further define 
other commands. 


Parameters 


You can specify parameters with subcommands or accept the defaults; valid entries and their defaults are 
shown in the command reference chapters. 


Basic Controls in Traditional Line Data 

The following line-printer controls may be included in a line data or unformatted ASCII file and can be used 
by a page definition to enable AFP functions: 

* Carriage control characters 

* Table-reference characters 

¢ Record Ids 


Carriage Control Characters (CC) 


Carriage control characters, which control line skipping, line spacing, and page ejection on line printers, 
are fields within line-data and unformatted-ASCII records. They are compatible with page printers when 
page definitions format the printed data. In page definitions, you can specify CHANNEL subcommands 
that correspond to carriage control characters corresponding to channels 1 through 12 in the data. When 
you do so, the carriage control characters operate just as they do in a line-printer environment. 


Note: ASCII ANSI, ANSI, and EBCDIC (machine) handle carriage control characters differently. See the 
SPACE_THEN_PRINT|subcommand listed in|“Subcommands’” on page 209]for more information. 
Table-Reference Characters (TRC) 


Table-reference characters (TRCs) control font selection in line-data and unformatted-ASCII output. Page 
definitions can be used to map table-reference characters to AFP fonts for use with page printers. 


Record Id 


Record ids are only used with the record formatting function. 
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Basic Controls in Record Format Line Data 


Record format line data is a new form of line data that is supported by the print server and formatted by a 
page definition. With this format, each data record contains a 10-byte record identifier that selects the 
record descriptor (RCD) in a record format page definition used to format the line data. This RCD might 
contain a carriage control (CC) byte. 

* Carriage control characters 

* Table-reference characters (not applicable in record format) 


Carriage Control Characters (CC) 


The CC byte is required when record format data is mixed with MO:DCA-P data, but is ignored. The CC 
byte is optional for record format line data at all other times, however if you enter it, you must inform the 
print server that it is there. 


Many functions used in the line descriptor (LND) to format traditional line data are used in RCD to format 
record format line data. Others, such as header and trailer processing, are unique to RCDs. 


Traditional line data is similar to record format line data in that neither is formatted into pages. However, 
traditional line data can be printed on line printers while record format line data cannot. For more 


information, refer to|Chapter 4, “Using Page Definition Commands for Record Format Line Data and XML 


Data” on page 59 


Note: ASCII ANSI, ANSI, and EBCDIC (machine) handle carriage control characters differently. See the 
SPACE_THEN_PRINT|subcommand listed in|“Subcommands’” on page 209]for more information. 


Table-Reference Characters (TRC) 


Table-reference characters (TRCs) cannot be used in record formatted line data. 


Record Id 


Record ids are only used with the record formatting function. They reside in the first 10 characters of each 
line data record, and control the layout type that is selected for each given record. These 10 characters 
are reserved for record ids and are not included as part of a defined field or conditional area. 


Structured Fields in Line Data 


To make use of the full function of page definitions and form definitions, MO:DCA-P structured fields may 
be required in the users data. The following MO:DCA-P structured fields can be included in a line-data or 
unformatted ASCII file (typically AIX) to activate AFP functions: 
: 


Include Page Seqmen 


Include Page Overlay 
Include Object 


Include Presentation Text (PTX) 
Include No Operation (NOP) 


Invoke Data Map 

Add the Invoke Data Map structured field to the line-data or unformatted ASCII file at a point that requires 
switching from one page format to another. The term “data map” is the name used for the term “page 
format” in PSF publications and PSF terminology. 
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Invoke Medium Map 


Add the Invoke Medium Map structured field to the line-data or unformatted-ASCII file at a point that 
requires switching from one copy group to another. The term “medium map” is the name used for the term 
“copy group” in PSF publications and PSF terminology. 


Include Page Segment 


Position the Include Page Segment structured field within the line or unformatted ASCII data for placing 
the page segment on the page. 


Include Page Overlay 


Position the Include Page Overlay structured field within the line or unformatted ASCII data for placing the 
overlay anywhere on the page. 


Include Object 


Position the Include Object structured field for placing an object containing other object types (for example, 
IOCA or BCOCA) for placing the object anywhere on the page. 


Presentation Text 


A presentation text object can be included in line data using the Presentation Text (PTX) structured field 
which is a self contained object consisting of line spacing, page margin, data position and font settings. 
Refer to the AFP Programming Guide and Line Data Manual, (S544—3864) and the Presentation Text 
Object Content Architecture Reference, (SC31—6803) for additional information. 


No Operation 


A No Operation (NOP) structured field can be placed in the line data stream. This can be used to insert 
information, such as a comment, into the data stream. 


Normal Duplex and Tumble Duplex 


Some page printers can print on both sides of a sheet, which is called duplex printing. Duplex printing can 
be done in four ways: 

Normal duplex 

Tumble duplex 

Rotated normal duplex 

Rotated tumble duplex 


In normal duplex, both sides have the same orientation, as in most books. In tumble duplex, the back of 
each page is upside down with respect to the front of the page: the top of one side of the sheet is at the 
same edge as the bottom of the other side. These two types of duplex allow you to specify top binding or 
side binding of the printed pages. 


Duplex also involves the commands RNORMAL (rotated normal) and RTUMBLE (rotated tumble), which 
are used with landscape-presentation pages to specify the type of duplex printing. See |Figure 13 on 


page 28] and/Figure 14 on page 29/for illustrations of duplex printing. 
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Chapter 2. Using Form Definition Commands 


A form definition is a resource, used by the print server, that specifies how the printer controls the 
processing of the sheets of paper. With form definitions, you can perform the tasks listed in|Table 1 


Table 1. Form Definition Tasks 


Tasks Location of Example 

Creating a form definition “Commands Required to Create a Form Definition” on 
page 20 

Positioning a logical page “Positioning a Logical Page on a Sheet” on page 21 

Specifying landscape presentation “OFFSET Subcommand with Rotated Print Direction” on 
page 22 

Specifying copies and electronic overlays “Specifying Copies and Electronic Overlays” on page 22 

Printing constant forms “Printing Constant Forms” on page 24 

Duplex printing in two orientations “Duplex Printing” on page 25 

Printing portrait and landscape “Duplex Printing in Portrait and Landscape Presentations” 
on page 27 

Specifying the page presentation on continuous-forms “Specifying Page Presentation on Continuous-Forms 

printers Printers” on page 29 

Migrating from 3800 printers to other IPDS printers “3800 Coexistence and Migration” on page 32 


Copy Groups and Subgroups 


A single form definition can contain several subsets of page controls, called copy groups. Copy groups 
define each physical page in the file. When you are printing jobs in duplex, the copy group defines both 
sides of the physical paper. Copy groups, in turn, can contain up to 127 subgroups, each of which creates 
a different set of modifications for the same page of data. 


A series of copy groups can be used where either the data or the printing requirements call for a variety of 
page control schemes. Part of the file can be printed from one (bin) paper source and part from another. 
Part can be printed duplex; part can be printed simplex. Duplex commands can be specified for a printer 
that does not support this function. This command treats the two adjacent pages as duplexed. A variety of 
controls can be contained in one form definition having several copy groups. 


You can control the following options within a copy group: 

* Position of the logical page on a sheet of paper 

* Duplex printing 

* Type of cut-sheet paper to be printed on (by choosing between paper input sources in page printers that 
have more than one paper source) 

* Offset stacking or copy marking of parts of a print job in the output stacker 

¢ Printing one, two, three, or four logical pages on a single side of a sheet 

¢ Vendor-attached devices for post-processing functions to be performed on the sheet 

¢ Print-quality level 


To access a new copy group within a form definition you can: 
¢ Add to your data file an Invoke Medium Map structured field immediately before the page of data that 
requires the new copy group. 


¢ Use a page definition that specifies conditional processing. When you access a new copy group, 
printing begins on the next physical sheet of paper. 


— 
ie) 
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For more information on the Invoke Medium Map structured field, refer to Mixed Object Document Content 
Architecture Reference. 


Subgroups allow the same page of data within a file to be printed more than once, using different sets of 
modifications each time the page is printed. One example is the printing of an invoice and a packing list 
from the same records in a data file. 


The following modifications to the page of data can be specified in a subgroup: 
* Selection of suppressed fields for the page 

* Selection of overlays used with the page 

* Selection of forms flash with the page (only on the 3800 printer) 

* Selection of the modification for front, back, or both sides of a sheet 

¢ Selection of the number of copies of the subgroup to print 

* Selection of the input bin 


Commands Required to Create a Form Definition 


The following simplified command stream shows the proper nesting of commands and the sequence in 
which the commands must be entered when you are creating a form definition: 
SETUNITS ] 
FORMDEF 
[SUPPRESSION ...] 
[COPYGROUP ] 
[OVERLAY ...] 
[SUBGROUP ...] 
[COPYGROUP ] 
[OVERLAY ...] 
[SUBGROUP ...] 


Notes: 


1. If the form definition has only one copy group, the COPYGROUP command can be omitted. The 
OVERLAY command then follows any SUPPRESSION command. 


2. Indentations are used to improve readability. 


3. Complete definitions of commands are in|Chapter 9, “Form Definition Command Reference” on 
age 169] 169 


Command Nesting Rules 
1. SUPPRESSION commands must be specified immediately after FORMDEF commands. 


2. SUBGROUP commands are specified under their associated COPYGROUP command or under the 
FORMDEF command. 


3. OVERLAY commands are specified immediately after COPYGROUP commands. 


4. The first COPYGROUP command can be omitted in a form definition if the form definition has only one 
copy group, and if it contains no OVERLAY commands. 


5. ASETUNITS command can be placed anywhere in the PPFA command stream and is in effect until 
another SETUNITS command is encountered. 

More than one of each command can appear under one form definition. 

If an OVERLAY occurs outside of a COPYGROUP (immediately after the FORMDEF), PPFA 
generates a COPYGROUP with the FORMDEF name. This becomes the first COPYGROUP and may 
not be the desired effect. If this occurs, PPFA issues a warning message . 


N © 
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Positioning a Logical Page on a Sheet 


The example in this section shows how the OFFSET subcommand is used to position the logical page on 
the physical sheet. A logical page is the area on a sheet of paper where all printing occurs. You establish 
the logical page origin, the point nearest the media origin, with the OFFSET subcommand. The OFFSET 
subcommand requires two coordinates and may have four. The first x and y coordinate defines the 
position on the front of the sheet, and the second x and y coordinate defines the position on the back of 
the sheet. A sample form definition that specifies the logical page position for a simplex sheet is: 


FORMDEF ABCD 
OFFSET 1 IN 1 IN ; 


Note: The 1 IN 1 IN is an abbreviation for 1 INCH 1 INCH. PPFA supports a number of different units of 
measurement formats. See |“Units of Measurement” on page 166/for all the different formats. 

The example places the logical page origin one inch to the right of and one inch down from the media 

origin. 


[Figure 6] shows the meaning of the x and y coordinates. In writing an OFFSET subcommand, the first 
parameter specifies x; the second parameter specifies y. If the x and y are repeated for the offset of the 
back side of the physical page, the same applies. The x defines the horizontal offset; the y defines the 
vertical offset. In this example, the logical page direction is ACROSS. The arrows within the logical page 
indicate the inline direction for text on the page. The lines of text are added according to the baseline 
direction. 


Media 
Origin a Logical Page 
\ Origin 
7 
Physical Logical 
Sheet Page 


Cut Sheet Page 


Figure 6. Origin of Logical Page 


Figure 7 on page 22|shows the meaning of x and yin a logical page specification for a 3900 sheet. The 


3900 sheet does not have an unprintable area, but FORMDEFs supplied with the print server have a 1/6 
inch offset. 
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3900 Continuous-Forms Page 


Figure 7. Origin of a Logical Page on a 3900 Sheet 


OFFSET Subcommand with Rotated Print Direction 


shows that the media origins and logical page origins do not change when the print direction of 
the page changes, although the way you view the page does change. The arrows within the logical page 
show the DOWN print direction—producing landscape page presentation. 


Be careful to coordinate form definitions and page definitions when you change between portrait and 
landscape presentations. 


Media Logical Page 
Origin N Xx Origin 
y | i 
| (t—+§__| 
Physical Logical 
Sheet Page 
vVvv 


Figure 8. The Meaning of OFFSET Parameters within a Landscape Page 


Specifying Copies and Electronic Overlays 


This example shows how to specify different electronic overlays in different subgroups. The electronic 
overlays you specify are created separately, using a program such as IBM Overlay Generation 
Language/370 or the AFP Utilities/400, and are stored as resources in the overlay library. No positioning 
controls are needed in the form definition with an overlay; the overlays are merely named. The overlay 
contains its own positioning data relative to the physical sheet. A form definition containing two overlays 
might look like this: 
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FORMDEF SLSCOM ; 
COPYGROUP SLSCOM ; 
OVERLAY SLSRPT M1001 ; /*LOCAL NAME AND USER-ACCESS NAMEx/ 
OVERLAY M1002 ; /*USER-ACCESS NAME ONLY x/ 
SUBGROUP COPIES 2 
OVERLAY SLSRPT ; 
SUBGROUP COPIES 3 
OVERLAY M1002 ; 


The steps to write this form definition are: 
1. Create a copy group. 
a. Write a COPYGROUP command. 
b. Write an OVERLAY command for each overlay. 


2. Create two subgroups by writing two SUBGROUP commands. Each subgroup contains an OVERLAY 
subcommand naming one of the selected overlays. 


Note: The overlays must be named in each copy group. 


Overlay Names 


To identify overlays by name, you must be aware of the three possible names for an overlay: a local name 
(SLSRPT) and two system names (M1001, 01M1001). The /ocal name is used only within the PPFA 
command stream; its use is optional. An example of this is SLSRPT in the first OVERLAY command of the 
previous sample command stream. 


The system name identifies an overlay in the library. It has two forms: the user-access name (M1001 in 
the sample set of commands) and the /ibrary-resource name. Of these, you use only the user-access 
name. PPFA automatically adds the O1 overlay prefix to the user-access name, which identifies the 
resource in the library. An overlay referenced through a form definition built with PPFA, therefore, must 
begin with the O1 prefix. An example of the result is O1M1001, the library-resource name. 


You can make up your own local name for an overlay. However, the local name must be used in the 
OVERLAY subcommand in the subgroup if it is used in an OVERLAY command for the copy group. If it is 
not, the subgroup must specify the user-access name, as has been done for overlay M1002 in the 
example. 


This example, specifying copies and electronic overlays, also specifies the number of copies of each 


subgroup. More than one copy of printed output can be requested by placing the COPIES subcommand 
and the number of copies of the subgroup desired in the SUBGROUP command. This example specifies 


that two copies of the first subgroup and three copies of the second subgroup are to be printed. See 
Figure 9 on page 24| which shows the result of printing a job that includes overlays as specified in the 


sample command stream at the beginning of this example. 
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Overlay SLSRPT Overlay M1002 


Figure 9. Two Electronic Overlays Incorporated into Two Subgroups 


Printing Constant Forms 


This example shows how to specify the constant-forms function using the CONSTANT command. The 
constant-forms function allows you to print overlays or a forms flash on blank pages without adding blank 
pages to your print job. Instead, the CONSTANT command generates blank pages on which to print the 
requested overlays and forms flash. These pages are called constant forms because no variable data from 
the print file is printed on the pages. 


You specify the CONSTANT command for an entire copy group; you identify the overlays and forms flash 
in the subgroups of the copy groups. 


The sample form definition XMPXXX shown below specifies that overlay XMP be printed on the back of 
each sheet with no variable data from the print job. The data from the print file is printed only on the front 
side of each sheet. 


FORMDEF XMPXXX 
REPLACE YES 
DUPLEX NORMAL ; 
COPYGROUP XMPXXY 
CONSTANT BACK ; 
OVERLAY XMP; 
SUBGROUP FRONT ; 
SUBGROUP BACK 
OVERLAY XMP; 


PAGEDEF XMPXXX 
REPLACE YES ; 
FONT NORMALFONT GT10 ; 
PAGEFORMAT XMPXXX 
PRINTLINE CHANNEL 1 REPEAT 20 
POSITION 1 1 ; 


The steps to write this form definition are: 
1. Create a copy group. 
a. Specify duplex printing. 
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b. Specify printing of a constant form as the back side of each sheet. 
c. Write an OVERLAY command. 


2. Create two subgroups by writing two SUBGROUP commands. The subgroup for the back side 
specifies the overlay to be printed. 


Note: If you do not specify an overlay in the subgroup for the back, the back side of each sheet will be 
blank. 


Duplex Printing 


Printing on both sides of a sheet (duplex printing) can be done in two ways: by the use of the FRONT and 
BACK subcommand combination or by the use of the BOTH subcommand. If FRONT and BACK are 
chosen, the number of copies requested for each must be the same. 


To demonstrate some of the functions available for duplex printing, assume you want to print a six-page 
data file (a simplified version is shown in|Figure 10). 


Page 1 
Page 2 Data File 


Page 3 


Page 4 


Page 5 


Page 6 


Figure 10. Six-Page Formatted Data File 


Assume, too, that the file is already composed and formatted, so only a form definition is needed. The first 
form definition follows: 
FORMDEF ABCD 
DUPLEX NORMAL ; 
OVERLAY AB ; 
SUBGROUP FRONT 
OVERLAY AB ; 
SUBGROUP BACK ; 


In this command stream, form definition ABCD contains two subgroups, one specified with a FRONT 
subcommand and the other with a BACK subcommand. 


By including a pair of FRONT and BACK subcommands within the copy group, you can specify that the 
front and back of printed sheets are to be controlled by different subgroups. The purpose of this is to allow 


modifications (overlays or suppressions, for example) to be separately specified for the front and back of 
sheets. |Figure 11 on page 26/shows the result of using this control where the front sheets have a header 
(OVERLAY AB) that the backs do not have. 
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Page 1 HEADER Page 2 
; | Sheet 1 Sheet 1 
Front Back 
Page 3 HEADER Page 4 
|#__—___ Sheet 2 Sheet 2 
Front Back 
Page 5 P. 6 
g | HEADER | Sheet 3 ae Sheet 3 
Front Back 


Figure 11. Result of Using a Pair of FRONT and BACK Subgroups 


The rules of the FRONT and BACK subcommands are: 

¢ FRONT and BACK subgroups must be specified in pairs. 

* Subgroups specifying FRONT must always immediately precede subgroups specifying BACK. 
* FRONT and BACK subgroups must agree in the number of copies. 


The BOTH subcommand also can be used with a form definition or a copy group that specifies duplex 
printing. An example of this type of form definition is: 


FORMDEF EFGH 
DUPLEX NORMAL ; 
SUBGROUP BOTH 
COPIES 2 ; 


The form definition EFGH contains only one SUBGROUP command. 


Notes: 


1. The copy group actually contains the subgroup, but if a form definition contains only one copy group, 
the copy group need not be specified. 


2. With the BOTH subcommand, you specify only one subgroup: both sides of all sheets have the same 
modifications. 


3. The above form definition does not put the same data on the front and back of the same sheet. 
Internally to PPFA, a single BOTH subgroup actually produces two subgroups. As a result, two pages 


of data (one for each internal subgroup) are processed before copy number 2 is made. For more 
information about this topic, see “SUBGROUP Command?’ on page 202 
Figure 12 on page 27|shows a sample print resulting from using the FORMDEF EFGH specifying BOTH to 


control the printing of the six-page (2 copies) data file. 
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Page 1 Page 2 Page 1 Page 2 


Sheet 1 Sheet 1 Sheet 2 Sheet 2 
Front Back Front Back 
Page 3 Page 4 Page 3 Page 4 
Sheet 3 Sheet 3 Sheet 4 Sheet 4 
Front Back Front Back 
Page 5 Page 6 Page 5 Page 6 
Sheet 5 Sheet 5 Sheet 6 Sheet 6 
Front Back Front Back 


Figure 12. Form Definition EFGH Using DUPLEX with BOTH 


Duplex Printing in Portrait and Landscape Presentations 


Duplex printing with PPFA and your print server printers offers several other options. This example shows 
the combination of portrait and landscape presentations with normal and tumble duplex printing. 


Note: The terms normal, tumble, portrait, and landscape are used in this example. They are explained in 
this chapter and in the Glossary. 


NORMAL and TUMBLE are parameters of a DUPLEX subcommand. For example, a form definition 
specifying DUPLEX NORMAL could be written this way: 
FORMDEF ABCD ; 
COPYGROUP ABCD 
DUPLEX NORMAL ; 
SUBGROUP BOTH 
COPIES 1 ; 


Document A in|Figure 13 on page 28}shows the result of a DUPLEX NORMAL specification in the portrait 


presentation. Document D shows the result of the same form definition when a landscape presentation is 
specified. The printout in landscape presentation is really in a tumble-duplex format, having the tops (of 
the front side) and the bottoms (of the back side) of the logical pages toward the same edge of the sheet. 
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Although tumble duplex can be specified in this manner for landscape pages, another parameter, 
RTUMBLE (rotated tumble), exists to make the form definition look more sensible for use in landscape 
print jobs. It also produces the results shown in [Figure 13} depending on whether the form definition called 
for portrait or landscape presentation. For landscape, the form definition should be written as follows: 


FORMDEF ABCD 
PRESENT LANDSCAPE ; 
COPYGROUP ABCD 
DUPLEX RTUMBLE ; 
SUBGROUP BOTH 


COPIES 1 ; 

Note: The example presented is for continuous printers. You must use N_UP for cut-sheet printers. In 
Chapter 9, “Form Definition Command Reference” on page 169| see the PRESENT subcommand of 
COPYGROUP. 

Top 
Beginning of page 101 ec 
a 
= 
: 
Endof page 100 Batten 
DocumentA- Portrait DUPLEX NORMAL Sheet 
Beginning of page 101 Top 
& 
5 
2 
Bottom 
DocumentD - Landscape DUPLEXTUMBLE Sheet 
(RNORMAL) 


Figure 13. DUPLEX NORMAL: Portrait and Landscape Presentation 


The DUPLEX NORMAL and DUPLEX RTUMBLE controls actually produce the same result on the 
physical page. RTUMBLE is used to maintain an association between duplex specifications and logical 
page print direction. The same relationship exists between the RNORMAL and the TUMBLE parameters 
as exists between the NORMAL and the RTUMBLE parameters; that is, within the two sets the terms are 


interchangeable. 


For example, you could write a form definition using DUPLEX TUMBLE as follows: 


FORMDEF DEFG ; 
COPYGROUP DEFG 
DUPLEX TUMBLE ; 
SUBGROUP BOTH 
COPIES 1 ; 


Documents C and B in}Figure 14 on page 29/are the results, depending on how page definition direction is 


specified to achieve either a portrait page or a landscape page. 
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Figure 14. Result When Either TUMBLE or RNORMAL Is Specified 


To help you remember, use]|Table 2 


Table 2. Duplex Specifications 


If the form definition duplex 
specification is... 


and if the page definition direction 
is... 


then, the duplex printing result is... 


DUPLEX NORMAL 


ACROSS or BACK 


normal duplex - portrait 


DUPLEX RTUMBLE DOWN or UP tumble duplex - landscape 
DUPLEX TUMBLE ACROSS or BACK tumble duplex - portrait 
DUPLEX RNORMAL DOWN or UP normal duplex - landscape 


Note: Other control combinations are not recommended. 


Specifying Page Presentation on Continuous-Forms Printers 


This example shows how to specify the page presentation (portrait or landscape) on printers that use 
continuous-forms paper. The page presentation is specified in the form definition using the PRESENT 
subcommand in conjunction with the DIRECTION subcommand. 


The PRESENT subcommand specifies how your pages will be presented when they are printed and has 
two valid values: PORTRAIT and LANDSCAPE. 


The DIRECTION subcommand specifies the inline direction in which your pages have been formatted by 
the page definition (see|“FIELD Command (Traditional)’ 


"on page 217) or by the program formatting the 
data. The DIRECTION subcommand has two valid values: ACROSS and DOWN. 


The conditions in which you should use these subcommands and some conditions in which they are not 
required are described below. For more information about how these subcommands work with data sent to 
specific printers, refer to the appropriate printer documentation. 
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In order to understand the description that follows, you must be aware of the difference between the two 
types of continuous forms: narrow and wide. Narrow forms are forms that have perforations on the shorter 
edge of the paper and tractor holes on the longer edge. Wide forms are forms that have perforations on 


the longer edge of the paper and tractor holes on the shorter edge. The two types of forms are illustrated 
in|Figure 15 


Paper Feed 
Direction 
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Narrow Form Wide Form 


Figure 15. Narrow and Wide Continuous Forms 


When to Use the PRESENT and DIRECTION Subcommands 


You should use the PRESENT and DIRECTION subcommands if you are building a form definition that will 
be used: 


e With wide forms on an IBM continuous forms printer when the print data has been formatted in the 


DOWN print direction (see |“The DOWN Direction for IBM Continuous Forms Printers”) 


¢ When you do not know which type of form (narrow or wide) will be used on an IBM continuous forms 
printer (see |“The DOWN Direction for IBM Continuous Forms Printers’) 


* To print data formatted for a 3800 printer on an IBM continuous forms printer (see|“3800 Coexistence 
and Migration” on page 32) 


* To migrate data previously printed on a 3800 printer to an IBM continuous forms printer (see}“3800 
Coexistence and Migration” on page 32) 


Note: References to an IBM continuous forms printer point of origin also applies to all continuous-forms 
printers except the 3800. 


When the PRESENT and DIRECTION Subcommands Are Not Required 


You do not need to use the PRESENT and DIRECTION subcommands if you are building a form definition 
that will be used: 


* With cut-sheet printers only 
¢ With narrow forms only 
¢ With the 3800 printer only 


¢ With print data that has been formatted in the BACK direction by the page definition or the program 
formatting the data 


The DOWN Direction for IBM Continuous Forms Printers 


If your data has been formatted in the DOWN print direction for landscape page presentation and is to be 
printed on wide forms on an IBM continuous forms printer, you must specify LANDSCAPE on the 
PRESENT subcommand to produce readable output. 
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lf PRESENT LANDSCAPE and DIRECTION DOWN are not specified on the FORMDEF command, the 
data is printed in the landscape presentation; however, the data will be upside down, as shown in 
| Figure 14] The data is upside down in this case because the media origin for an IBM continuous forms 
| printer is located on the same corner of the form, regardless of whether a narrow or wide form is being 


used (see [Figure 16}. 
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NO ° ° 
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Cut-Sheet or Narrow Wide 3835 Pages 


Continuous-Forms Pages 


| Figure 16. The Results of Not Specifying PRESENT LANDSCAPE and DIRECTION DOWN on an /BM Continuous 
| Forms Printer 


If PRESENT LANDSCAPE and DIRECTION DOWN are specified on the FORMDEF command, the data 
will be printed as shown in|Figure 17} In this example, line data is formatted using a page definition. 


PRESENT LANDSCAPE and DIRECTION DOWN can also be specified for data formatted in the DOWN 
print direction that will be printed on narrow forms. Although PRESENT LANDSCAPE and DIRECTION 
DOWN do not need to be specified in this case in order to produce readable output, specifying them 
enables you to use the same form definition regardless of whether the data will be printed on wide forms 
or narrow forms. 


Note: If you are building a form definition that can be used with both wide and narrow forms, remember 
that the left margin as viewed by the reader becomes the top margin from the printer’s perspective 
(and vice versa). Because many printers have an unprintable area at the margins, you should 
position the logical page using the OFFSET subcommand in the form definition, so data will not be 
placed in the unprintable area on either wide or narrow forms. 
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| Figure 17. The Results of Specifying PRESENT LANDSCAPE and DIRECTION DOWN on an /BM Continuous Forms 
| Printer 


3800 Coexistence and Migration 


The PRESENT and DIRECTION subcommands should be used if you are doing either of the following: 


| © Building a form definition that will be used to print data formatted for the 3800 on the 3800 and IBM 
| continuous forms printers 


| © Migrating data formatted for the 3800 printer to an IBM continuous forms printer 
¢ Migrating data formatted for an impact printer 


| printable area on an IBM continuous forms printer, as shown in The data exceeds the valid 
| printable area in this case because the media origin of the IBM continuous forms printer is different from 
the media origin of the 3800 printer. 


If the PRESENT and DIRECTION subcommands are not specified, the print data may exceed the valid 
Figure 13] 18 
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| Figure 18. The Results of Not Specifying PRESENT and DIRECTION When Migrating from a 3800 to an IBM 
| Continuous Forms Printer 
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When you are building a form definition for migration or coexistence from the 3800 to an IBM continuous 
forms printer, code the PRESENT and DIRECTION subcommands as follows: 


1. If you have a 3800 wide-forms application formatted in the ACROSS or UP direction that you want to 
print on wide or narrow forms on an IBM continuous forms printer, specify PRESENT LANDSCAPE 
and DIRECTION ACROSS. 


2. If you have a 3800 wide-forms application formatted in the DOWN direction that you want to print on 
wide or narrow forms on an IBM continuous forms printer, specify PRESENT PORTRAIT and 
DIRECTION DOWN. 


3. If you have a 3800 narrow-forms application formatted in the ACROSS direction that you want to print 
on narrow or wide forms on an IBM continuous forms printer, specify PRESENT PORTRAIT and 
DIRECTION ACROSS. 


4. If you have a 3800 narrow-forms application formatted in the DOWN direction that you want to print on 
narrow or wide forms on an IBM continuous forms printer, specify PRESENT LANDSCAPE and 
DIRECTION DOWN. 


Note: You can only specify ACROSS and DOWN on the DIRECTION subcommand when you are 
building a form definition for 3800 to an IBM continuous forms printer migration or coexistence. 


Figure 19 on page 34/illustrates the output on 3800 or an IBM continuous forms printer with all four 


combinations of PRESENT and DIRECTION. These illustrations assume that the type of forms were not 
changed from one printer type to another. 


The PRESENT and DIRECTION subcommands should also be used if you want to print data formatted for 
the 3800 printer on a different type of forms (narrow versus wide) on an IBM continuous forms printer. The 
combinations of PRESENT and DIRECTION to use when performing this type of migration are included in 
Line Item 2, as previously listed. 


Note: When you migrate an application from one type of forms to another, remember that the top and left 
margins from the printer's perspective change places. Because many printers have an unprintable 
area at the margins, you should position the logical page using the OFFSET subcommand in the 
form definition, so data will not be placed in the unprintable area on the forms you are migrating to. 
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If you want output Specify: Or use this 
formatted for the 3800 IBM supplied 
to look like this FORMDEF: 
on the 3835 or 3900: 


FORMDEF ABCD F10101LA 
PRESENT LANDSCAPE 
DIRECTION ACROSS ; 


ABCD 


OQ27e200000000 
000200000000 


FORMDEF ABCD F10101PD 
PRESENT PORTRAIT 
DIRECTION DOWN ; 


qodv 


O©°7e070000000 


Q0°0000000000 


FORMDEF ABCD F10101PA 
PRESENT PORTRAIT 
DIRECTION ACROSS ; 


ABCD 


0°0000000000000000 
000000000000000000 


FORMDEF ABCD F10101LD 
PRESENT LANDSCAPE 
DIRECTION DOWN ; 


qdodv 


000000000000000000 
090000000000 000000 


| Figure 19. PRESENT/DIRECTION Combinations When Using the Same Forms Type on 3800 and an IBM Continuous 
| Forms Printer 


Print Quality Control 


If your printer has more than one print-quality selection, you can specify different levels of print quality. For 
more information refer to the manual for your printer. 
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Chapter 3. Using Page Definition Commands for Traditional 
Line Data 


A page definition specifies how you want data positioned on the logical page. 


A page definition is a resource used by print servers to define the rules of transforming line data and 
unformatted ASCII into composed pages and text controls for printing. With page definitions, you can 
perform the tasks listed in|Table 3 


Table 3. Page Definition Tasks 


Tasks Location of an Example 

Creating a page definition 

Defining logical page size 

Positioning data on a logical page “Positioning the First Line of Data” on page 37] 

Changing the print direction 
Printing tne data 
Processing fields [*Processing Fields” on page 45] 

Changing fonts “Varying Fonts on a Page” on page 48 

Printing in different directions “Printing Lines in Two Directions on a Page” on page 51 


Printing fields in two directions 
page 52 

Rotating fonts (‘Rotating Fonts” on page 53] 

Printing kanji 

Printing multiple up “Printing Multiple-Up Pages” on page 55) 


Page Formats within Page Definitions 


Just as form definitions can include more than one copy group, page definitions can include several page 
formats. Page formats use the same subcommands (except REPLACE) as page definitions, and if a 
subcommand is specified in a page format, it overrides the value specified in the page definition for the 
page format. A single page definition may contain multiple page formats. If pages in a file are to be 
formatted differently, specify more than one page format in your page definition. Within a page definition, 
page formats are generated in the order in which they are specified. 


Using more than one page format to control different pages requires one of the following: 
¢ Adding the Invoke Data Map structured field to the data file each time you want to change page formats 
¢ Using conditional processing. 


Refer to Advanced Function Presentation: Programming Guide and Line Data Reference for more 
information about the Invoke Data Map structured field. 


Page Definition Command Nesting 


The following simplified command stream shows the proper nesting of commands and the order in which 
they must be entered when you create a page definition: 


[SETUNITS] 

PAGEDEF 
[FONT] 
[OBJECT] 


o 
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[PAGEFORMAT] 
[TRCREF] 
[OBJECT] 
[SEGMENT] 
[OVERLAY] 
PRINTLINE 
[FIELD] 
[CONDITION] 
[ENDSUBPAGE] 
[SETUNITS] 


Notes: 

1. Brackets enclosing a command mean the command is optional. 
A command and its subcommands end with a semicolon. 
Indentations are used to improve readability. 


Complete definitions of all commands are included in|Chapter 10, “Page Definition Command 
Reference (Traditional)” on page 207 


Pon 


Command Nesting Rules 

1. FONT commands must be specified immediately after PAGEDEF commands. 

2. ASETUNITS command can be specified anywhere in the PPFA command stream and is in effect until 
another SETUNITS command is specified. 

3. OBJECT commands may appear after the FONT command, before any PAGEFORMAT command 
(global objects) or after a specific PAGEFORMAT command. A global object is defined for all page 
formats in the page definition. Otherwise the object is just defined for the PAGEFORMAT in which it is 
specified. 

4. TRCREF, SEGMENT, and OVERLAY commands must be specified under their associated 
PAGEFORMAT command. 

5. The first PAGEFORMAT command can be omitted in a page definition, if the page definition has only 
one page format. 

6. At least one PRINTLINE command is required. 


Defining Logical Page Size 
“Positioning a Logical Page on a Sheet” on page 21|shows how to establish the origin point of a logical 


page, relative to the media origin on a sheet of paper, using the OFFSET subcommand. The following 
example shows you how to establish the width and height of the logical page relative to this origin point. 
This example illustrates how the dimensions of a logical page are determined by form definitions and page 
definitions. 
FORMDEF ABCD 

OFFSET (1) (2) ; 
PAGEDEF ABCD 

WIDTH (3) 

HEIGHT (4) ; 

PRINTLINE 


Note: The parenthetical numbers represent dimensions. |Figure 20 on page 37| shows how these 


dimensions relate to the logical page. 


Normally, all parameters consist of a number and a unit of measurement, for example, 6 IN. (See [Units off 
Measurement” on page 166/for information on units that are available.) Numbers can be specified with up 
to three decimal places. The PRINTLINE command is included because at least one is required for all 


page definitions; see |“PRINTLINE Command (Traditional)” on page 244] for more information. 


36 = PPFA User’s Guide 


Figure 20. Logical Page Dimensions 


The OFFSET subcommand (1) (2) in the sample form definition establishes the corner or origin of the 
logical page relative to the physical sheet. The WIDTH and HEIGHT subcommands, (8) and (4), specify 
the dimensions of the logical page relative to the logical page origin. 


Note: Be careful not to define a logical page larger than the physical sheet. PPFA does not check the size 
of the physical sheet. 


“Positioning the First Line of Data’| shows you two ways to position the first line of data on the page. 


Positioning the First Line of Data 


The previous section showed you how to define the size of a logical page. The next two examples show 
you how to position the first line of data inside the logical page, using the LINEONE subcommand. This 
subcommand position is relative to the logical page origin, as shown in The two coordinates, (1) 
and (2), of the LINEONE parameter define the starting point for the first line of text. 


eer @ 
| | 


Figure 21. LINEONE Coordinates 


This starting point works with the POSITION, MARGIN, and TOP subcommands (of the PRINTLINE 
command) to position lines of print on a page. 


The defaults for LINEONE are: 


x = 0, 
y = 80% of one line space from the top of the logical page: 
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80% of 1/6 inch if lines per inch (lpi) = 6, 
80% of 1/8 inch if lpi = 8, and so on. 


These defaults leave room for the character ascenders in the first line of text. 


Note: PPFA subtracts one logical unit (L-unit) from the y value to compensate for the fact that the printer 


counts L-units beginning with the number 0. Therefore, if you specify the offsets to the first line in 
L-units (PELS is the measurement command for L-units) using the LINEONE subcommand, you 
must remember to subtract one L-unit from the y offset value. This is necessary to prevent 
descenders on the last printed line from dropping off the bottom of the logical page. 


The following examples illustrate two methods for positioning the first line of text: 


i 
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The position of the first line of data defaults by specifying the SETUNITS command prior to the 
PAGEDEF command, like this: 


SETUNITS 1 IN 1 IN 
LINESP 8 LPI; 
FORMDEF ABCD 
OFFSET @ .5; 
PAGEDEF ABCD 
WIDTH 7.5 
HEIGHT 10 
DIRECTION ACROSS; 
FONT GS12 GS12; 
PRINTLINE REPEAT 60 
FONT GS12 
POSITION © TOP; 


Note: It is important that the LINESP subcommand (of the SETUNITS command) must precede the 
PAGEDEF commands. 


If the LINESP subcommand follows the PAGEDEF command, PPFA then uses the default LINESP 
value to calculate the y offset value, which is used to position the first line of print. 


The default for the LINESP subcommand of the SETUNITS command is 6 Ipi. If LINEONE is allowed 
to default, based upon the LINESP default, the LINEONE value is 31 L-units: 


LINEONE = ( ( 240 L-units / 6 lpi ) x 80% ) - 1 L-unit= 31 L-units. 


This valueis the vertical (y) position of the printline because TOP is specified in a later POSITION 
subcommand. However, this value may cause the data to exceed the bottom boundary of the logical 
page if the LINESP value is changed later. 


Another way you can specify the starting position for the first print line is to specify LINEONE explicitly, 
like this: 


FORMDEF ABCD 
OFFSET 0 .5; 
PAGEDEF ABCD 
WIDTH 7.5 
HEIGHT 10 
LINEONE 0 PELS 23 PELS 
DIRECTION ACROSS; 
SETUNITS 1 IN 1 IN 
LINESP 8 LPI; 
FONT GS12 GS12; 
PRINTLINE REPEAT 60 
FONT GS12 
POSITION © TOP; 
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In this example, the LINESP subcommand following the PAGEDEF command will not cause a data 
placement problem because the LINEONE command determines explicitly where the first line of text is 
positioned, and no default LINESP value is used: 


LINEONE = [ ( 240 L-units / 8 Ipi ) x 80% ] - 1 L-unit= 23 L-units 


If you use the LINEONE command to specify an absolute starting position for the first line, in L-units, 
you must remember to subtract one L-unit from that value. 


Changing Logical Page Print Direction 


Logical pages can have four different print directions: ACROSS, DOWN, BACK, and UP. This example 
shows that all four directions can be specified in relation to one offset specification: 


FORMDEF ABCD 
OFFSET (1) (2) ; 
PAGEDEF DEFG ; 
PAGEFORMAT DEFG1 
WIDTH (3) 
HEIGHT (4) 
DIRECTION ACROSS ; 
PRINTLINE ; 
PAGEFORMAT DEFG2 
WIDTH (3) 
HEIGHT (4) 
DIRECTION DOWN ; 
PRINTLINE ; 
PAGEFORMAT DEFG3 
WIDTH (3) 
HEIGHT (4) 
DIRECTION BACK ; 
PRINTLINE 
PAGEFORMAT DEFG4 
WIDTH (3) 
HEIGHT (4) 
DIRECTION UP ; 
PRINTLINE ; 


One page definition is used to simplify the example, yet four logical pages are specified. The 
PAGEFORMAT commands create subsets of page definitions for each logical page. 


Note: The page formats in this example require an Invoke Data Map structured field at the place in the 
data file where you want to change page formats. The PRINTLINE commands are required but are 
not relevant in the example. 


The DIRECTION subcommand with one of its four direction parameters (ACROSS, DOWN, UP, or BACK) 
specifies the print direction of the logical page. 


Figure 22 on page 40}shows the format of each of the logical pages specified in the page definition with 


the direction specification of each. The pages with the ACROSS and BACK directions are in portrait 
presentation. The pages with the DOWN and UP directions are in landscape presentation. 
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Figure 22. Logical Page Print Directions in Relation to Origin 


The media origins and logical page origins do not change with the presentation of the data on the page. 
The OFFSET subcommand of the form definition need not change. However, the width and height 
dimensions do change; that is, the WIDTH subcommand always governs the horizontal (inline) dimension 
as you view the page, and the HEIGHT subcommand always governs the vertical (baseline) dimension 
whether the page is in portrait or in landscape presentation. Ensure that these specifications do not cause 
the logical page to cross the edge of the physical page. 


However, if the DOWN direction is specified for use with an IBM continuous forms printer, the PRESENT 
and DIRECTION subcommands may need to be specified in the form definition. See|“Specifying Page 
Presentation on Continuous-Forms Printers” on page 29}for more information. 

Printing Line Data on a Print Server Printer 


This example shows how you can print a data file developed for a line printer on a page printer without 
altering the data. The example compares the effects of line printer controls with the corresponding controls 
in the PPFA commands and subcommands. PRINTLINE, LINESP, POSITION, CHANNEL, and REPEAT 
are page definition controls related to the lines of text in your printout. Line printer controls examined are 
the forms control buffer (FCB) and carriage control characters. 


40 PPFA User’s Guide 


As shown in|Figure 23} a file consisting of 13 records is to be printed. Several different printouts of this 
data are formatted in the following examples. In the first two printouts, records 1-6 are printed on page 1, 
records 7—9 on page 2, and records 10-13 on page 3. 


Carriage- 
Control 
Character 


1_| RECORD 1 
RECORD 2 
RECORD 3 
RECORD 4 
RECORD 5 
RECORD 6 
1_| RECORD 7 
RECORD 8 
RECORD 9 
1 | RECORD 10 
RECORD 11 
RECORD 12 
RECORD 13 


Data 


Figure 23. Line-Data File 


Figure 24 on page 42/shows the formatting process used when the file is printed on a line printer. For 


many line printers, an FCB is used to format the output in the S/370 (OS/390, VM, VSE) environment. The 
sample FCB represented in[Figure 24 on page 42|determines that no printed page contain more than eight 
lines. A page can have exactly eight lines without using carriage control characters in the data. A page 
may contain any number of lines fewer than eight; this is effected by placing fewer than eight records 
between the carriage control characters in the data. In the data file in [Figure 24 fewer than eight records 
are, in all cases, placed between channel 1 carriage control characters. A ninth record, if encountered 
before a carriage control character, would cause a page eject and a return to the beginning of the FCB. 


The printout shown in|Figure 24 on page 42|results from the data being formatted by this FCB. 
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Figure 24. Data File Printed on a Line Printer 


A page definition can work exactly the same way. Consider the following example: 


SETUNITS 1 IN 1 IN 
LINESP 6 LPI ; 
PAGEDEF ABCD 
WIDTH 5 
HEIGHT 7 
LINEONE .5 .5) 3 
PRINTLINE CHANNEL 1 
POSITION MARGIN TOP 
REPEAT 8 ; 


This command stream contains one new command (PRINTLINE) and four new subcommands (LINESP, 
CHANNEL, POSITION, and REPEAT) related to controlling individual lines. 


* The subcommand has the same function as the LPI specifications in the FCB or in a Printer File; it 
defines the line density LINESPn lines per inch. 

¢ The PRINTLINE command contains the controls for one or more lines. 

¢ The CHANNEL subcommand has the same function as the channel 1 control character in the FCB, 
causing a page eject at each channel 1 control character encountered in the data records. 

¢ The POSITION subcommand establishes the location of the first line relative to the upper-left corner of 
the logical page. This example uses the MARGIN and TOP parameters; however, numeric parameters 
similar to those used with the OFFSET subcommand can also be used. Those values are also relative 
to the logical page. 


* The REPEAT subcommand is a commonly used control in PPFA text formatting. It is the way you 
specify the total number of PRINTLINEs in a logical page. 
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Note: The constraints in specifying a REPEAT value and, thereby, the number of lines per page are: 
the lines-per-inch specification, the height of the logical page, and the font selection. The 
REPEAT variable “8” is chosen to equal the maximum number of records to be printed per page. 
As in the line printer version, if a ninth record were encountered before a channel 1 carriage 
control character, a page eject would occur and the line would be printed as the first line at the 
top of the next page. 


The result of this page definition is represented in|Figure 25 


Printout 
Logical Page 1 Logical Page 2 Logical Page 3 
f — Records —— Records —— |} Records 
1-6 7-9 10-13 
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Figure 25. Printout Examples Specifying POSITION MARGIN TOP 


Changing line printing specifications for the following example is shown in|Figure 26 


Printout 
Logical Page 1 Logical Page 2 Logical Page 3 
7 
7IN. 
~ — Records —=—F+ Records —— } Records 
-| 4-6 7-9 10-13 
v 


Figure 26. Printout Example Specifying POSITION MARGIN 4.1 


SETUNITS 1 IN 1 IN 
LINESP 6 LPI ; 
PAGEDEF ABCD 
WIDTH 5 
HEIGHT 7 
LINEONE .1 .1 3 
PRINTLINE CHANNEL 1 
POSITION MARGIN 4.1 
REPEAT 8 ; 
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Observe that the second parameter of POSITION is no longer TOP; instead it is 4.1, which places the first 


line of text 4.1 inches down the page rather than at the top (Figure 26 on page 43). 


Printout 
Logical Page 1 Logical Page 2 
1 —= —— 
— Records —=— | Records 
- 1-6 10-13 
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Figure 27. Printout Example Specifying POSITION MARGIN TOP and POSITION MARGIN 4.1 


The following example and|Figure 27|show a third version of the possible formats for the data represented 
in|Figure 24 on page 42 


SETUNITS 1 IN 1 IN 
LINESP 6 LPI ; 
PAGEDEF ABCD 
WIDTH 5 
HEIGHT 7 
LINEONE .1 .1 3 
PRINTLINE CHANNEL 1 
POSITION MARGIN TOP 
REPEAT 8 ; 
PRINTLINE CHANNEL 1 
POSITION MARGIN 4.1 
REPEAT 8 ; 


You also can skip over space using carriage control characters. This example shows how to do this by 
using a second PRINTLINE command to create a second starting position on the page (as shown in 
Figure 27). The second starting position is vertically 4.1 inches down from the top of the page; see the 
second POSITION subcommand. The two CHANNEL 1 subcommands take turns mapping the records 
governed by the successive channel 1 carriage control characters in the data to their specified positions 
on the page. In this case, the carriage control 1 characters cause printing to alternate between the TOP 
position (0.1 inch down the page) and 4.1 inches down the page. 


The OS/400 Environment 


This example shows how you can print a data file developed for a line printer on a page printer without 
altering the data, within the OS/400 environment. 


If, in DDS, the following example were used: 


Page length=66, LPI=6, OVRFLW=60 (10 inches) 
Print 36 lines at 6 LPI (6 inches) 
Print 16 lines at 4 LPI (4 inches) 


you could get the same formatting in PPFA by coding: 


PAGEDEF MIXLPI 
WIDTH 8 IN 
HEIGHT 10 IN 
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LINEONE x Y 
SETUNITS LINESP 6 LPI; 
PRINTLINE POSITION MARGIN TOP 
REPEAT 36; 
SETUNITS 4 LPI; 
PRINTLINE REPEAT 16; 


Processing Fields 


This section describes the mapping of individual fields to the printed sheets. The technique allows you to 
print unformatted data according to precise specifications, and these specifications can change without 
affecting the data file. 


The rules for field processing of data files are: 


* Each record in your file must correspond to a separate PRINTLINE command because each record is 
mapped separately. When processing identical fields, you can define a single printline and use the 
REPEAT subcommand. 


¢ Each FIELD command must follow its associated PRINTLINE command, and more than one FIELD 
command can be specified for a single PRINTLINE command. 


For this field-processing example, the data file shown in|Figure 28) is used. |Figure 29 on page 46 
represents an output format that could be used to place data on a form, such as an invoice or an order. 
The page definition commands to print|Figure 29 on page 46/are as follows: 


PAGEDEF ABCD 


WIDTH 7 IN 
HEIGHT 8 IN ; 
PRINTLINE POSITION 1 IN 1 IN ; /*PROCESSING FOR R1 x/ 
FIELD START 1 LENGTH 4 ; /*THE PRINTLINE POSITION IS */ 


/*THE DEFAULT FOR THE FIRST FIELD*/ 
FIELD START 11 LENGTH 4 
POSITION 4 IN 0 IN ; 

PRINTLINE POSITION 3 IN 4 IN ; /*PROCESSING FOR R2 x/ 
FIELD START 1 LENGTH 4 ; /*DEFAULT POSITION x*/ 
FIELD START 6 LENGTH 4 

POSITION 0 IN 1 IN ; 
FIELD START 13 LENGTH 3 
POSITION 2 IN 3 IN ; 

PRINTLINE POSITION 1 IN 2 IN ; /*PROCESSING FOR R3 x/ 
FIELD START 1 LENGTH 4 ; /*DEFAULT POSITION x/ 
FIELD START 11 LENGTH 4 

POSITION 4 IN 0 IN ; 


123456789 123 4567 
RI [AJAJAIA B |B |B |B 
R2 [x|x|x|x]_|Y/V lvl Z|Z|Z|z 
R31} 1f1}1 2|2|2/2 
Data File 


Figure 28. Unformatted Print Data File 
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as ZZZ 


Figure 29. Data Arranged on the Printed Page 


POSITION Subcommand as Used in this Example 


The POSITION subcommand of each PRINTLINE command specifies the printline position relative to the 
logical page origin. The POSITION subcommands below FIELD commands specify a field position relative 
to the governing printline position. Following POSITION subcommands come the horizontal (x) then the 
vertical (y) offsets from the reference point. They are parallel in structure to the OFFSET subcommand of 
the form definition. 


For example, the final POSITION subcommand places the final field 1 + 4 inches to the right of the left 
edge of the logical page, combining the x value of 1 in the PRINTLINE command, and the x value of 4 in 
the nested FIELD command. The 0 in the FIELD command specifies no change to the y value in the 
PRINTLINE command. Thus, the position of the final field is 5 IN (x), 2 IN (y). 


Note: The first FIELD command within each PRINTLINE has no position specification, because the 
PRINTLINE POSITION value is the default for the first FIELD command nested under it. 


Alternate controls for the x and y values of a POSITION subcommand are available. See the description of 
the POSITION subcommand in|“FIELD Command (Traditional)” on page 217) and|“PRINTLINE Command 
(Traditional)” on page 244 


FIELD Command as Used in this Example 


In the FIELD command, the START and LENGTH parameters specify the location of the field in the record 
to be processed. START indicates the starting byte position, and LENGTH specifies the number of bytes 
in the field. 


Because a field can be located independently within the data and on the printed page, more than one 


page definition or page format can be created for the same data file, each specifying different mapping of 
the data to the output pages. 
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Color on the IBM Infoprint HiLite Color Post Processor 
This section provides an example of the use of Highlight color. shows where the text 


is placed on the page. The CALIBRATION setup is as follows: 


Start pel Color Width in pels 
200 high 1 288 
488 high 2 288 
776 high 3 192 


The page definition commands to print |Figure 31 on page 48/are as follows: 


PAGEDEF XMP1 
WIDTH 7 IN 
HEIGHT 8 IN 
REPLACE YES; 


PRINTLINE 
POSITION .83 IN 1 IN 3 
FIELD START 1 LENGTH 4 
HIGHLIGHT 1; /* 'AAAA' */ 


FIELD START 11 LENGTH 4 
POSITION 2.4 IN O IN 
HIGHLIGHT 3; /* 'BBBB' x/ 


PRINTLINE POSITION 2.03 IN 4 IN 3 
FIELD START 1 LENGTH 4 
HIGHLIGHT 2; /* —'XXXX! */ 


FIELD START 6 LENGTH 4 
POSITION © IN 1 IN 
HIGHLIGHT 2; /* 'YYYY! x/ 


FIELD START 13 LENGTH 3 
POSITION 1.2 IN 3 IN 
HIGHLIGHT 3; /* ‘ZZZ' */ 


PRINTLINE POSITION .83 IN 2 IN 3 
FIELD START 1 LENGTH 4 
HIGHLIGHT 1; /* ‘1111! x/ 


FIELD START 11 LENGTH 4 
POSITION 2.4 IN O IN 


HIGHLIGHT 3; /* '2222' */ 
We 32 8) oh GGT BEAD 123 4567 
R1 JAJA\AIA B |B /B |B 
R2 |X{xX|x|x} lylYlYlY Z|z|z|z 
R38 ]1) 1/11 2|2/2)2 
Data File 


Figure 30. Unformatted Print Data File 
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A 
: AAAA BBBB 
_ 1111 2222 
BIN. _ XXXX 
= YYYY 
_ ZZZ 
v 


Figure 31. Data Arranged on the Printed Page with Color 


The data 'AAAA' and '1111' are printed in highlight color 1. The data 'XXXX' and 'YYYY' are printed in 
highlight color 2. The data 'BBBB’, 'ZZZ', and '2222' are printed in highlight color 3. 


Setup Verification 
You can use the VFYSETUP subcommand to put the name of the printer color setup into the form 


definition. At print time, the print server compares the setup name in the form definition to verify that the 
setup was activated in the printer. See the VFYSETUP subcommand in|“FORMDEF Command” on 
page 185] 185 


for more information. 


Varying Fonts on a Page 


This example illustrates a simple font variation within a printout. The task is to print a line-data file having 
the first line of each page in bold-faced type and the rest in standard type. This requires controls for two 
fonts in the page definition. 


The commands to select a single font for the page, as shown in|Figure 32 on page 49} are as follows: 


The FONT command contains two names: the local (STANDARD) name and the user-access (M101) 
name for the selected font. 


PAGEDEF ABCD ; 
FONT STANDARD M101 ; 
PRINTLINE ; 


Note: Fonts cannot be an FGID. Also, all page definitions require a PRINTLINE command. 
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Figure 32. Data File Printed Using a Single Font 


Page 2 


Page 3 


The next command stream changes the font by incorporating a TRCREF command. Assume the data file 


to be formatted incorporates table reference characters (TRCs) as shown in|Figure 33 on page 50 


PAGEDEF ABCD ; 
FONT STANDARD M101 ; 
FONT BOLDFACE M102 ; 
PAGEFORMAT ABCD ; 
TRCREF 0 
FONT STANDARD ; 
TRCREF 1 
FONT BOLDFACE ; 
PRINTLINE CHANNEL 1 


/*CREATING LOCAL FONT NAMES 


/*DEFINING THE TRC VALUES 


POSITION 1 IN 1 IN 


REPEAT 8 ; 
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*/ 


*/ 
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CCTRC 
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0| Record 4 
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Record 5 
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Figure 33. Font Change Using TRCREF Command 


The TRCs in the data cause the font switch to be made. The TRCREF command equates a TRC in the 
data file with the local name of a font specified in the FONT command. The FONT command also contains 
the user-access name for the font. See for information on local names and 
user-access names. Because of the relationship among the user-access name, the local name, and the 
TRC number that is established in the page definition, the TRCs in the data can cause a font switch 
automatically. 


You can specify fonts within a PRINTLINE command when the data file contains no TRCs. For example: 


PAGEDEF ABCD ; 
FONT M101 ; 
FONT BOLDFACE M102 ; 
PRINTLINE CHANNEL 1 /*BOLDFACE LINE */ 
POSITION MARGIN TOP 
FONT BOLDFACE ; 
PRINTLINE POSITION MARGIN NEXT /*STANDARD-TYPE LINE */ 
FONT M101 
REPEAT 7 3 


assume the data file represented in the sample print in|Figure 34 on page 51|is to be formatted by this 


page definition. 


This command stream, based on a data file without TRCs, works on the principle that each line of output 
whose font you want to change from the font in the previous line must be controlled by a separate 
PRINTLINE command. The FONT subcommand of the PRINTLINE command names the font desired for 
that line. In this example, two PRINTLINE commands are used because one font change and two fonts 
are intended for the output. The user-access font names appear in the two FONT commands immediately 
below the PAGEDEF command and, optionally, a local name. M101 and M102 in the example are 
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user-access names; BOLDFACE is a local name. Use the local name in the FONT subcommand of 
PRINTLINE if it is included in the corresponding FONT command, as is done for the first PRINTLINE 
command. 
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Page 1 Page 2 Page 3 
Figure 34, Font Change Using FONT Commands and Subcommands 


Changing fonts field by field is similar to changing them in printlines. You map each field individually with a 
FIELD command; include a FONT subcommand in the FIELD command. If a font change is desired for a 
field, as with the FONT subcommand of a PRINTLINE command, the font must be previously named in a 
FONT command. 


Two possible defaults apply in case you do not specify a font within a field. If the governing printline has a 
FONT subcommand, it contains the font default for the field. If the governing printline has no font 
specification, the print server assigns a font according to its default rules. 


Printing Lines in Two Directions on a Page 


Lines can be printed in any of four directions, depending on the type of printer being used. Refer to 
Advanced Function Presentation: Printer Information for the print directions supported by your printer. 


The four parameters for line direction are ACROSS, DOWN, BACK, and UP. The PPFA commands used 


to format a line-data file with lines printed in more than one direction (as shown in|Figure 35 on page 52 
are stated in the following page definition: 
PAGEDEF ATOG 
DIRECTION ACROSS ; 
PRINTLINE POSITION 1 IN 1 IN /*LINES A-E  */ 
REPEAT 5 ; 
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PRINTLINE POSITION .5 IN 6 IN /*LINE F */ 
DIRECTION UP ; 


PRINTLINE POSITION 1 IN 6 IN ; /*LINE G */ 
<=—— 5in. —— 

AAAAA | eee 
BBBBB a BBBBB 
CCCCC Fin, ~|&CCCCC 
DDDDD |e 

-EEEEE| 7 ,,PDDDD 
"FEFEE | wEEEEE 
GGGGG  PS@E66E 

Data File 


Figure 35. A Printout with More Than One Line Direction 


In this page definition, the logical page direction ACROSS is specified. This is actually the default, but its 
inclusion clarifies that no direction control is needed for lines A-E. The default direction of a printline is the 
direction specification of the logical page of which it is part. The PRINTLINE command for the record F 
has a DIRECTION subcommand because the direction specification changes from that of the previous 
line. Record G is to be printed in the ACROSS direction again. A direction is not specified, however, 
because the ACROSS direction is the default for all lines in this page definition. 


Note: If you are building the page definition for use with the 3800 printer, and if the input data contains 
table reference characters, you can use the DIRECTION subcommand of the TRCREF command to 


specify a font that_prints UP on the page, as in line F. For more information, see |‘TRCREF| 
Command (Traditional)” on page 261 
Printing Fields in Two Directions on the Same Page 


This example is similar to]Printing Lines in Two Directions on a Page} except that you learn how to control 


direction field by field. This method creates a field-processing page definition and places direction controls 
in the FIELD commands. This command stream contains a portion of the page definition controls, showing 
only the PRINTLINE commands: 
PRINTLINE POSITION MARGIN TOP ; 

FIELD START 1 LENGTH 4 ; 
PRINTLINE POSITION 2 IN 4 IN ; 

FIELD START 7 LENGTH 4 

DIRECTION UP ; 


As expected in field processing, FIELD commands are nested within PRINTLINE commands. |Figure 36 on 
age 53] 


ge 53]/shows a simplified portion of an unformatted file and two pages of the printout formatted by the 
page definition, part of which is shown in the command stream. Two printlines are specified because, as 
gure 96.671 page 64 shove the data file contains two input record formats (1 and 3 are alike; 2 and 4 are 
alike) and because the fields are mapped to two different positions in the output. The assumption of this 
sample is that the data file is actually much longer than the portion shown. If, however, the records in the 


file alternate in format as the first four do, the two PRINTLINEs of this page definition formats as many 
records as are presented, two to a page, on pages 1 through n. 


If more than two mappings are required by the print job, more than two PRINTLINE commands are 
required in the page definition. 
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Figure 36. Field Direction 
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Data File 


Rotating Fonts 


Fonts rotate relative to the inline direction of lines (or fields). 


This example focuses on a single letter A from FONTA. With PPFA, a single font specified in a page 
definition can produce letters in any of four rotations. This is accomplished by a FONT command that 
specifies rotation. If, as in this example, you want to vary the rotation of a font twice within a page, you 
use two FONT commands, one for each rotation. You also use two PRINTLINE commands to map the 
data to the printout, using the two rotations of the font. In a field processing application, FIELD commands 
can be used in the same way. These PRINTLINE commands name the rotated font in a FONT 
subcommand. 


Figure 37|breaks down the elements required for the FONT commands and subcommands. Distinct local 
names and rotation specifications for each font are placed in a FONT command. These identify a font as 


rotated within a page definition. The rotation of a character is relative to the inline direction of a printline or 
field. The characters and rotations shown here assume an inline direction of ACROSS. See|“PPFA Basic 


Terms” on page 8 


FONT command Name Rotation 
A A 
Local Name 1 Rotation 0 A 0° 
Local Name 2 Rotation 90 > 3 90° 
) User-access Rotation 180 y 270 
Local Name 3 naire otatio 
Local Name 4 Rotation 270 < 180° 


FONT subcommand, FIELD command 


Figure 37. Character Rotation 


You can use up to 16 possible combinations of logical page direction and font rotation for page printers 
other than the 3800. 


The FONT subcommands within PRINTLINE or FIELD commands that name the rotated font in that page 
definition use only the local name. The following command stream shows the proper specification and 
nesting of FONT commands and subcommands for rotation. 
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PAGEDEF ABCD ; 


FONT FONTA M103 ; /*NO ROTATION, LOCAL AND */ 
/*USER-ACCESS NAMES. */ 
FONT FONTARTD180 M103 /*ROTATED FONT, LOCAL, USER-ACCESS*/ 
ROTATION 180 ; /*NAMES PLUS ROTATION SUBCOMMAND  */ 
/*AND PARAMETER, */ 
PRINTLINE FONT FONTA /*LOCAL NAME */ 
REPEAT 3 ; 
PRINTLINE FONT FONTARTD180 /*LOCAL NAME */ 
REPEAT 2 ; 
AAAA 
AAAA 
AAAA 
VVVV 
VVVV 


Figure 38. Example of Assumed Data File and Rotation Specifications 


FONTA, identified in the first FONT command, requires no rotation parameter because it is printed in the 
default position (or 0° rotation) for font M103. For the rotated font, the second FONT command identifies 
FONTARTD180 (the local name) as M103 rotated 180°. 


Using Traditional Kanji Formatting 


Traditional kanji print presentation, called tate, is possible with printer, using a combination of font rotation 
and logical page direction. A logical page in the DOWN direction and a 270° font rotation provide the right 
combination to present kanji in tate format on the printer. 


FORMDEF TATE 
OFFSET 1 IN 1 IN ; 
PAGEDEF TATE 
HEIGHT 5 IN 
WIDTH 6 IN 
DIRECTION DOWN ; 
FONT KANJIRTD M104 
ROTATION 270 ; 
PRINTLINE FONT KANJIRTD 
REPEAT 3 ; 


Figure 39 on page 55}shows the result of formatting with the above page definition. The characters are 


added to lines down the page. Lines are added right to left. 
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Figure 39. AFP Printer Tate Presentation 


Printing Multiple-Up Pages 


Multiple up is a printer’s term for printing two or more pages of data on one side of a sheet, which is 
possible with your print server printers and PPFA formatting. The steps used in this example are: 


1. Change the print direction of the logical page to one of the landscape presentations. 
2. Conceptually divide the sheet of paper into parts, one for each multiple-up page (subpage). 
3. Create a printline position at the top of each multiple-up page. 


This example assumes the existence of a line-data file with carriage control 1 characters after records 4, 

7, and 11. Each carriage control 1 character begins a new page. Because there are really four pages on 
the sheet, a skip-to-channel 1 must be used four times. The fifth channel 1 character causes a page eject 
and the beginning of a new physical sheet. The PPFA commands that follow are for one version of a 
multiple-up page. This set of commands creates a page layout like the one shown in [Figure 40 on page 56| 
(the physical sheet is not shown). 


FORMDEF MULTUP 
OFFSET 1 IN .5 IN ; 
SETUNITS LINESP 4 LPI ; 
PAGEDEF MULTUP1 
WIDTH 10 IN 
HEIGHT 8 IN 
DIRECTION DOWN /*FOR LANDSCAPE PRESENTATION x/ 
PRINTLINE CHANNEL 1 /*PAGE 1 */ 
POSITION 1 IN 1.5 IN 
REPEAT 6 ; 
ENDSUBPAGE ; 
PRINTLINE CHANNEL 1 /*PAGE 2 */ 
POSITION 1 IN 5.5 IN 
REPEAT 6 ; 
ENDSUBPAGE ; 
PRINTLINE CHANNEL 1 /*PAGE 3 */ 
POSITION 6 IN 1.5 IN 
REPEAT 6 ; 
ENDSUBPAGE  ; 
PRINTLINE CHANNEL 1 /*PAGE 4 */ 
POSITION 6 IN 5.5 IN 
REPEAT 6 ; 
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Figure 40. Multiple-Up Page Layout 


The DOWN printline direction creates a page with a landscape presentation typical of multiple-up printing. 
Individual printlines are specified for the initial lines of the four pages. Ensure that the lines of each page 
fit in the space designated by the use of a small font. 


Note: In this example, no font is specified for the page definition; therefore, the default font for the page 
printer is used. If you want a different font, write a FONT command naming it. 


The next set of commands alters the sequence of pages. 


FORMDEF MULTUP 
OFFSET 1 IN .5 IN ; 
SETUNITS LINESP 4 LPI ; 
PAGEDEF MULTUP2 
WIDTH 10 IN 
HEIGHT 8 IN 
DIRECTION DOWN ; 
PRINTLINE CHANNEL 1 /* PAGE 1 */ 
POSITION 1 IN 1.5 IN 
REPEAT 4 3; 
ENDSUBPAGE ; 
PRINTLINE CHANNEL 1 /* PAGE 2 */ 
POSITION 6 IN 1.5 IN 
REPEAT 4 ; 
ENDSUBPAGE ; 
PRINTLINE CHANNEL 1 /* PAGE 3 */ 
POSITION 1 IN 5.5 IN 
REPEAT 4 ; 
ENDSUBPAGE ; 
PRINTLINE CHANNEL 1 /* PAGE 4 x/ 
POSITION 6 IN 5.5 IN 
REPEAT 4 ; 


Here, the upper-right and lower-left pages have been reversed by reversing the position controls for the 
second and third printlines. 


Figure 41 on page 57|shows the changed printout resulting from the page definition command changes. 


Once you have set up your basic page definition, changes such as this become easy. 
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Page 1 Page2 
Record 1 Record 5 
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Figure 41. Multiple-Up Page Layout after Page Definition Modification 


Note: The ENDSUBPAGE command can be used to mark the boundaries between subpages. Without it, 


the page definition is no different from any other sequence of PRINTLINEs with POSITION 
commands. Boundaries do not have to be marked unless conditional processing is being 


performed. The examples given here print identically with and without ENDSUBPAGE commands. 
(See|“Subpage Description and Processing” on page 120 
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for more information.) 
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Chapter 4. Using Page Definition Commands for Record 
Format Line Data and XML Data 


Record Formatting Function 


The record formatting function allows an application to specify a format identifier (Record ID) with each set 
of output data fields (Data Record). The format identifier references a specific layout format in a page 
definition (PAGEDEF). At print time, each layout format (referenced by a Record ID in a Data Record) is 
retrieved from the PAGEDEF and used to position and format the associated Data Records/fields on the 
output page. 


The purpose of the record formatting capabilities is to move more of the output formatting function into the 
PAGEDEF and allow for greater flexibility in creating and changing output pages without changing the 
base application. Rather than the application generating page headers, page trailers and group headers 
for each page (and thereby fixing the page endings), the page headers, page trailers and group headers 
can be generated by a PAGEDEF layout, allowing the page endings to change as font sizes or data 
layouts change. 


In order to visualize how the record formatting function can be used, review the first six pages of|“Record 


Formatting Examples” on page 79| These examples show the output of an application before and after It is 
formatted with PAGEDEF using the record formatting functions. 


These functions are provided by several new PPFA commands (LAYOUT, DEFINE COLOR, 
DRAWGRAPHIC, and ENDGRAPHIC), and modifications to the PAGEDEF, PAGEFORMAT, FONT, 


CONDITION, and FIELD commands. This chapter provides an explanation of the record formatting 
functions with examples of their use. For details on the syntax of these commands, see}Chapter 11, “Page 
Definition Command Reference (Record Formatting and XML)” on page 263 

Some of the functions that can be accomplished in a layout format with the record formatting commands 
include: 


¢ Selecting different formatting for different types of Data Records/fields based on the Record ID. The 
output formatting can change mid-page independent of where the output occurs on a page. 


¢ Defining page headers and trailers to be automatically printed on subsequent pages. The headers and 
trailers can incorporate data from the associated Data Record. 


¢ Numbering the output pages. 
* Inserting page ejects can be automatic when text reaches the bottom margin. 


* Creating group headings to be printed at the beginning of a group of data. For example, you can create 
group headings (including column headings) to be repeated each time a different account type is 
formatted on a banking statement. An active group heading is automatically repeated on subsequent 
pages until the data group ends. 


* Forcing page ejects to occur in the output. 


* Creating boxes with or without black and white or color shading. A set of boxes for a table can be 
started in a group header and automatically ended and restarted on subsequent pages until the table 
completes. 


* Creating graphical objects such as circles, ellipses, lines, graphs, and so forth in color or black and 
white output. 


* Formatting database records created with field delimiters (rather than fixed length fields). 
* Aligning field output to the left or right. 
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Record Format Page Definition 
A record format page definition specifies how you want data positioned on the logical page. 
A record format page definition is a resource used by the print server that defines the rules of transforming 


line data and unformatted ASCII into composed pages and text controls for printing. With record format 
page definitions, you can perform the tasks listed in|Table 4 


Table 4. Record Format Page Definition Tasks 


Tasks Location of an Example 

Creating a page definition “Page Definition Command Nesting” on page 61 

Record ID “Record ID Data Format” on page 61 

Layout Command 

Body Records 

Fields 

Defining logical page size “Defining Logical Page Size” on page 68 

Positioning data on a logical page “Positioning the Data” on page 69 

Changing the print direction “Changing Logical Page Print Direction” on page 69 

Processing fields “Processing Fields” on page 72 

Changing fonts “Varying Fonts on a Page” on page 75 

Printing in different directions “Printing Lines in Two Directions on a Page” on page 74 

Printing fields in two directions “Printing Fields in Two Directions on the Same Page” on 
page 74 

Rotating fonts “Rotating Fonts” on page 77 

Printing kanji “Using Traditional Kanji Formatting” on page 78 

Example formats and commands “Record Formatting Examples” on page 79 


Page Formats within Page Definitions 

Just as form definitions can include more than one copy group, page definitions can include several page 
formats. Page formats use basically the same subcommands as page definitions, and if a subcommand is 
specified in a page format, it overrides the value specified in the page definition for the page format. A 
single page definition may contain multiple page formats. If pages in a file are to be formatted differently, 
specify more than one page format in your page definition. Within a page definition, page formats are 
generated in the order in which they are specified. 


Using more than one page format to control different pages requires one of the following: 


¢ Adding the Invoke Data Map structured field to the data file each time you want to change page 
formats. 


¢ Using conditional processing. 


Refer to Advanced Function Presentation: Programming Guide and Line Data Reference for more 
information about the Invoke Data Map structured field. 
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Page Definition Command Nesting 


The following simplified command stream shows the proper nesting of commands and the order in which 
they must be entered when you create a page definition: 
[SETUNITS] 
PAGEDEF 
FONT 
[OBJECT] 
[DEFINE COLOR] 
[PAGEFORMAT ] 
[SEGMENT] 
[OVERLAY] 
[LAYOUT] 
[CONDITION] 
[FIELD] 
[DRAWGRAPHIC] 
[ENDGRAPHIC] 
[PAGEFORMAT ] 
[SEGMENT] 
[OVERLAY] 
[LAYOUT] 
[CONDITION] 
[FIELD] 
[DRAWGRAPHIC] 
[ENDGRAPHIC] 


Notes: 
1. Brackets enclosing a command mean the command is optional. 
2. Indentations are used to improve readability. 


3. Complete definitions of all commands are included in|Chapter 11, “Page Definition Command 
Reference (Record Formatting and XML)” on page 263 


Command Nesting Rules 


1. Record format LAYOUT commands and traditional PRINTLINE commands cannot be used within the 
same PAGEDEF. At least one LAYOUT command is required per page format for a record formatting 
page definition. 

2. ASETUNITS command can be placed before any other PPFA command. The values set are in effect 
until the next SETUNITS command. 

3. SEGMENT and OVERLAY commands must be specified under their associated PAGEFORMAT 
command. 

4. The first PAGEFORMAT command can be omitted in a page definition, if the page definition contains 
only one page format. If the PAGEFORMAT command is omitted, the PAGEDEF command parameters 
are used to define the page format. 


5. One file can contain multiple sets of page definitions. 


Record ID Data Format 


In order to allow different formats for different groups (or tables) of data, each of which have an 
unpredictable number of entries, a Record ID is assigned to each output record to identify the type of 
record and control layout formatting. An application can group data fields that are to be formatted together 
as an entity into Data Records with a specific Record ID. For example, in a bank statement, the data fields 
for a check transaction might be grouped together with a Record ID identifying that record as a check 


transaction. The PAGEDEF would then define a special layout format for a check transaction with a 
matching Record ID (see|“Record Formatting Examples” on page 79] for detailed examples). 

Record formatting in PPFA is achieved by identifying each input record in the data file with a 10 byte ID 
similar to an expanded carriage control (CC) (see|“Basic Controls in Record Format Line Data” on page 12 
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for additional information). Each record in the data file must contain a Record ID if record formatting is 
used. The Record ID must be the first 10 bytes in every print record in the data file. 


Even though the Record ID is specified as a character string, the Record ID is treated as a hexadecimal 
string, not a character string. This means there is no translation from ASCII to EBCDIC or vice versa when 
the Record ID is processed. The Record ID in the input data must match exactly the string specified for 
the LAYOUT Record ID in the page definition in order for correct processing to occur. 


When a record is read from the data file at print time, the print server uses the 10 byte Record ID to 
determine which LAYOUT command in the page definition should be used to format the record. 


TRCs (Table Reference Characters) cannot be used with record format data. If you have TRCs in the data 
and tell the print server that TRCs are present at print time, the print server uses the TRC byte as the first 
byte of the Record ID, and the Record ID is not recognized as such. 


Data files can contain both carriage controls and Record IDs. If your data file is mixed mode (line data 
plus MO:DCA structured fields), then you must have a CC byte in the data. The CC byte is not counted as 


part of the 10 byte Record ID. If your file is plain line data, then CCs are allowed but not required. (See 
“Basic Controls in Record Format Line Data” on page 12|for additional information.) 
LAYOUT Command 


When record formatting, the LAYOUT command is used instead of traditional PRINTLINE commands in 
the page definition. You cannot mix record format LAYOUT and traditional PRINTLINE commands in the 
page definition. With LAYOUT (see |‘“LAYOUT Command (Record Format)” on page 323}, you can identify 
four types of Data Records: 


¢ Body Records 
* Page Headers 
¢ Page Trailers 

¢ Group Headers 


Each of the record types is discussed in the following sections. No matter which type of record you are 
formatting, you can control the positioning, font, color, and direction for the print record. 


The POSITION keyword on the LAYOUT command is used to set the initial print position for subsequent 
text and graphics placed with the FIELD and DRAWGRAPHIC commands. 


* The horizontal position can be specified as LEFTMARGIN, at the same position as the previous 
layout, or at an absolute or relative location given in inches, millimeters, centimeters, points, or pels 
(see[PAGEDEF Command (Record Format and XML)" on page 340), 

¢ The vertical position can be specified as TOPMARGIN, at the same position as the previous layout, at 
the next vertical position (using current LINESP value), or at an absolute or relative location given in 
inches, millimeters, centimeters, points, or pels (soe [PAGEDEF Command (Record Format and XM) 
lon page 340}. 


Body Records 

The BODY layout type is used for the majority of data in the user’s input file. That is, any record that is not 
used for special processing as a page header, page trailer, or group header, contains data to be formatted 
and placed on the page. 


Body records are positioned initially with the LAYOUT command. The default x (horizontal) position for 


each body record is to be at the same horizontal position as the previous LAYOUT. If this is the first 
LAYOUT on a logical page, the default horizontal position is 0. 
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The default y (vertical) position is to place the layout record down one line (as defined in the LINESP 
subcommand of the last SETUNITS command) from the previous field. If this is the first LAYOUT on a 


logical page, the default vertical position is one line down from the top margin of the logical page. See 
“PAGEDEF Command (Record Format and XML)” on page 340] for details about margins. 

You can specify the rotation of data with the DIRECTION keyword on LAYOUT. All of the fields defined for 
this record layout uses the same direction unless it is overridden on the FIELD command. On relative 


LAYOUTs and their fields, the rotation must be ACROSS, so that they have the same net rotation as the 
page format. 


You can also specify fonts and color to be used for the text formatted with this layout record. Double-byte 


fonts can additionally be requested if you have double byte characters in your data. The color of the text 
and graphic borders is specified with the COLOR keyword. See|“DEFINE COLOR Command (Record 
Format and XML)” on page 270}and|“FONT Command (Record Format)” on page 317/for details. 

Page segments, overlays and objects can be included with keywords on the LAYOUT command. This 
processing is the same as the traditional PRINTLINE command. 


Body records can also be identified as belonging to a group. When the GROUP keyword is used on the 
body LAYOUT, the group header that is in effect at the time is repeated on subsequent pages as long as 
the input records use Record ID’s that select body LAYOUT and use the GROUP keyword. The group is 
ended as soon as a Record ID in the input selects a LAYOUT that does not use the GROUP keyword. 


Page Headers and Trailers 


Page headers and trailers are printed automatically on each new page. Default headers and trailers can 
be created, which are automatically invoked on each new page without requiring or allowing any input 


data. No input record data is allowed in a default header or trailer because they are triggered automatically 
by page ejects and are not associated with any records in the input data file. See|“LAYOUT Command 
(Record Format)” on page 323 


for additional details. 


Rather than using the defaults, you can create headers and trailers that are invoked by a Data Record 
containing the header or trailer Record ID. These headers and trailers can use input record data in their 
layout, however it is not required. 


The following example creates a page header and trailer. See |‘PAGEDEF Command (Record Format and 
XML)" on page 340] 


” on page 340}for additional details. 


LAYOUT C'statmid' 
SEGMENT ibmlog 1.15 in 1.35 in 
PAGEHEADER NEWPAGE 
POSITION SAME ABSOLUTE NEXT; 


LAYOUT C'pgenum' PAGETRAILER 
POSITION SAME ABSOLUTE 10.7 in; 


Figure 42. Sample Page Header and Trailer 


Group Headers 


A Group Header layout consists of text, graphics, and other data that is to be printed at the beginning of a 
group of user records. For example, if you are creating a banking statement, you might define a Group 
Header for checking, one for savings, and so forth. 


The group header is defined with a special LAYOUT GRPHEADER command, and stays in effect until a 
BODY layout is encountered that specifies NOGROUP. See|“LAYOUT Command (Record Format)” on 
page 323 


for additional details on the GRPHEADER subcommand. 
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If a logical page eject occurs before the group is ended, the header is printed after the top margin on each 
new page until the group ends. 


FIELD Command 


The FIELD command is used to identify a field in a Data Record to be formatted and placed on the page. 
FIELD must follow the LAYOUT command, and parameters that are not specified on FIELD are inherited 
from the previous LAYOUT. This section describes the new keywords on FIELD that are used with record 
formatting. 


Page numbering can be accomplished by specifying FIELD with the PAGENUM parameter. Most often, 
you specify FIELD PAGENUM with other formatting information such as position and alignment, which 
causes the current page number to print at the specified position. The current page number is calculated 
based on the specification of the PAGECOUNT parameter on the previous PAGEDEF or PAGEFORMAT 


command. You can override the page number to a specific value using the RESET parameter on the 
FIELD command. For details, see ‘Page Numbering” on page 66 

You can retrieve the value of the Record ID for printing using the RECID keyword on FIELD. RECID also 
has START and LENGTH subparameters to allow only portions of the Record ID to be printed. Normally, 


you only use the RECID parameter for debugging your application by tracing which Record IDs are being 
processed, although it can be used for anything that makes sense for your application. 


You can also specify the POSITION, COLOR, DIRECTION, and ALIGN keywords with the PAGENUM or 
RECID parameters on FIELD. The BARCODE and SUPPRESSION keywords are not allowed with 
PAGENUM or RECID, but can be used with other text fields from the Data Record. 


ALIGN is a keyword that is allowed with the START/LENGTH or TEXT forms of the FIELD command, but 
only if you are doing record formatting. ALIGN lets you specify whether the field text should be LEFT or 
RIGHT aligned at the given horizontal position. 


If your Data Records are stored in a database, the fields may be separated with “field delimiters” instead 
of just being positional within the record. The DELIMITER keyword on the preceding LAYOUT command is 
used to specify the one- or two-byte value that is used to separate fields in the Data Records. 


If your data uses field delimiters, you can also specify the FLDNUM parameter on the FIELD command to 
indicate the number of the field within the record to be extracted, rather than the START position. Fields 
are numbered from left to right beginning with “1”. You can also use the starting position (START) and 
LENGTH keywords with the FLDNUM to indicate that only part of the field is to be formatted. An example 
of a typical command is: 
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COMMANDS 


LAYOUT 'abc' DELIMITER 'x'; 
FIELD FLDNUM 1 START 2 LENGTH 8 ALIGN RIGHT 
POSITION 5.6 in CURRENT 
FONT varb ; /* Variable text - Amount */ 
FIELD FLDNUM 2 ALIGN LEFT 
POSITION 1.1 in .9 in 
FONT varb ; /*variable - customer name */ 


DATA 
abc *Here is some data*more data* 


FIELDS used 
Ist field ‘ere is s' 
2nd field ‘more data' 


Figure 43. Sample Commands and Data With Delimiters. 


Controlling Page Formatting 


Parameters on the PAGEDEF and PAGEFORMAT commands let you specify the margins of the page. 
The TOPMARGIN and BOTMARGIN keywords are used to reserve space at the top and bottom of the 
page. The page headers and trailers are normally placed into this reserved space. 


Note: No other text or objects should be written into the margins - only page header and trailer data. 


The bottom margin is also used for two other purposes: 

¢ a BODY or GRPHEADER Data Record that would cause the baseline position to move into the bottom 
margin area causes a logical page eject 

* any graphic that has been started with the DRAWGRAPHIC command, but not explicitly ended, 
automatically ends at print time before it extends into the bottom margin area. 


You can force a new logical page in the output with the NEWPAGE keyword on a LAYOUT command (see 
FLAYOUT Command (Record Format)" on page 323}. When an input record is encountered whose Record 
ID matches that LAYOUT name, a page eject is completed before the record data is processed. If this is a 
header or trailer layout, the page eject is performed before the header or trailer becomes active. 


The ENDSPACE keyword can also be used to control where page ejects are performed. If ENDSPACE is 
coded on a LAYOUT, and a Data Record with the matching Record ID is encountered, a page eject is 
performed before the data is processed - if the remaining space on the page (before the bottom margin) is 
less than the ENDSPACE value. 


The ENDSPACE keyword can be used to ensure that a Table Heading (Group Heading) does not print at 
the end of a page without allowing space for additional Data Records (body records), or to ensure that a 
table entry does not print at the bottom of a page without allowing space for a totals record. 


The following example shows the use of page margins and the NEWPAGE and ENDSPACE keywords: 
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PAGEFORMAT chubl TOPMARGIN 2 in BOTMARGIN 2 in; 


[BRK R KER AK KEIR KEK KEIR KEK KEKE KEKE KEK EKER AREER | 


/** statmid BODY xx / 


[BERR KER A KK EAA KEK KEK KEI KKK KK KEK KEKE KKK ERKREREKE | 
LAYOUT C'statmid' PAGEHEADER NEWPAGE ENDSPACE .5 in 
POSITION .6 in ABSOLUTE .55 in; 
FIELD TEXT C'Big Brother Bank' ALIGN LEFT 
FONT comp ; /* default to LAYOUT positioning*/ 


Figure 44. Sample Page Formatting 


Page Numbering 


Page numbers can be placed with the PAGENUM keywords on the FIELD command. PAGENUM lets you 
specify whether the page number should print or not, and whether you want it reset to a specific value 
rather than using the current value (page count). 


The page number prints as an integer (for example, 1, 2, 3, ...) and has a valid range of 1 to four billion 
(four unsigned bytes of data). If the specified or defaulted font used for printing the page number is other 
than an EBCDIC font, you must specify it using the TYPE subcommand on the FONT command. 


The page number prints using the font specified on the FIELD command. You can also select a 
POSITION, COLOR, and DIRECTION for the page number using existing FIELD keywords. 


The ALIGN parameter on FIELD can also be used to specify whether you want the page number LEFT or 
RIGHT aligned at the given position. 


The PAGECOUNT keyword is allowed with the PAGEDEF and PAGEFORMAT commands that allows you 
to specify how page numbering is to be handled when switching between page formats. Page numbering 


can be stopped, reset, resumed for a certain point or continued from a certain point. For a detailed 
description on how to specify these options, see |“PAGEDEF Command (Record Format and XML)” on 
page 340] 340 


Graphical Objects 


When creating output with record formatting, you can use the DRAWGRAPHIC commands to create 
boxes, lines, circles, and ellipses relative to the data printed with the LAYOUT command. 
DRAWGRAPHIC can be used with DEFINE COLOR to shade an object with a percentage of black or 
other colors, however DRAWGRAPHIC is not allowed if you are formatting with the traditional PRINTLINE. 


Conditional Processing Considerations 


Conditional processing works much the same in record formatting as when using the traditional 
PRINTLINE processing. The only difference is the ability to process based upon a field that is defined by 
delimiters instead of just a fixed start position and length. 


Logical Page Eject Processing 
A logical page eject can be caused by the following: 
¢ Any Record ID that references a layout format with a specification of New Page. 


¢ A relative baseline overflow (a Body or Group Header layout format that when processed against the 
current input record causes an overflow of the current print position into the bottom margin). If 
processing of the input record would cause a relative baseline overflow, the page eject is processed 
before any part of the input record is printed. 


¢ A Data Map change or Medium Map change, or, in Mixed-Mode, a Begin Document or Begin Page 
structured field. 
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Page Header, Page Trailer, and Group Header Data Records used with page ejects are activated in the 
following manner: 


If a Data Record specifies the Record ID of a PAGEDEF Page Header layout format, that Data Record 
is not printed on receipt but is saved as the active page header record (for that PAGEFORMAT). It is 
saved for the duration of the job or until a subsequent Data Record specifies a Page Header (for that 
PAGEFORMAT). 


If a Data Record specifies the Record ID of a PAGEDEF Page Trailer layout format, that Data Record is 
not printed on receipt but is saved as the active page trailer record (for that PAGEFORMAT). It is saved 
for the duration of the job or until a subsequent Data Record specifies a Page Trailer (for that 
PAGEFORMAT). 


lf a Data Record specifies the Record ID of a PAGEDEF Group Header layout format, that Data Record 
is not printed on receipt but is saved as the active group header record. The PAGEDEF Group Header 
is printed when the next Data Record specifies a Body layout with a GROUP specification and on 
subsequent page ejects. The Group Header and its associated Data Record is kept active until a 
subsequent Data Record specifies a Body layout with a NOGROUP specification. 


When a logical page eject occurs, the following actions are taken in the following order. 


For the current page: 


1. If this is the start of a line data document (no previous page ejects, group header records or body 
records have been processed with this PAGEDEF), current page items 1 through 3 are skipped. 


2. If an active page header record was in effect prior to this layout format, that record is presented on 
the current page using the matching layout. Otherwise, if the active PAGEFORMAT contains a 
default Page Header layout, that layout is used to present a page header. 


3. If an active page trailer record was in effect prior to this layout format, that record is presented on 
the current page using the matching layout. Otherwise, if the active PAGEFORMAT contains a 
default Page Trailer layout, that layout is used to present a page trailer. 


For the new page: 


1. The current print position is moved to the top of the new page and offset from the top of the new 
page by the top margin. If the PAGEFORMAT is changed, the new Data Map’s Margin Definition 
and layouts are used. 


2. If an active group header record exists for this PAGEFORMAT, that record is presented on the new 
page using the matching Record layout. Note that the group header is not actually printed and 
causes no action until a Body layout with Group Indicator is processed for the page. If the layout 
specifies relative positioning, the baseline position of the layout is offset from the top of the page by 
the top margin plus one line. 


3. If the page eject was caused by a Body layout, the input record causing the page eject is presented 
on the new page using the layout referenced by the record. If the layout specifies relative positioning 
and is preceded on the page by a group header, the baseline position is relative to the last printed 
line of the group header. If the layout specifies relative positioning and is not preceded on the page 
by a group header, the baseline position of the layout is offset from the top of the page by the top 
margin plus one line. 


Note: The actual locations of ‘top of page’ and ‘top margin’ are affected by the text orientation. See [‘Using] 
Margins in Record Formatting” on page 70} for additional information. 
Defining Color Models 


Record formatting provides you with the ability to predefine a color with your own name and then use that 
name anytime this color is needed. It works in much the same way as a FONT command where you 
define the FONT with an internal name and then use that name when you place text on the page. 
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Defining Logical Page Size 
“Positioning a Logical Page on a Sheet” on page 21|shows how to establish the origin point of a logical 


page, relative to the media origin on a sheet of paper, using the OFFSET subcommand. The following 
example shows you how to establish the width and height of the logical page relative to this origin point. 
This example illustrates how the dimensions of a logical page are determined by form definitions and page 
definitions. 


SETUNITS 1 IN 1 IN 
LINESP 8 LPI; 
FORMDEF ABCD 
OFFSET © .5; 
PAGEDEF ABCD 
WIDTH 7.5 
HEIGHT 10 
DIRECTION ACROSS; 
FONT GS12 GS12; 
LAYOUT 'abc' 
FONT GS12 
POSITION © TOP; 


Normally, all parameters consist of a number and a unit of measurement, for example, 6 IN. (See [Units off 
Measurement” on page 166}for information on units that are available.) Numbers can be specified with up 
to three decimal places. The LAYOUT command is included because at least one is required for all page 
definitions; see|“LAYOUT Command (Record Format)” on page 323}]for more information. 

Orn 


i" 
2) 
4 


Figure 45. Logical Page Dimensions 


The OFFSET subcommand (0) (.5) in the sample form definition establishes the corner or origin of the 
logical page relative to the physical sheet. The WIDTH and HEIGHT subcommands, (7.5) and (10), specify 
the dimensions of the logical page relative to the logical page origin. 


Note: Be careful not to define a logical page larger than the physical sheet. PPFA does not check the size 
of the physical sheet. 
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Positioning the Data 


The previous section showed you how to define the size of a logical page. The next examples show you 
how to position data inside the logical page. 


Changing Logical Page Print Direction 


Logical pages can have four different print directions: ACROSS, DOWN, BACK, and UP. This example 
shows that all four directions can be specified in relation to one offset specification: 


FORMDEF ABCD 
OFFSET (1) (2) ; 
PAGEDEF DEFG 
FONT GS12 GS12; 
PAGEFORMAT DEFG1 
WIDTH (3) 
HEIGHT (4) 
DIRECTION ACROSS ; 
LAYOUT 'abc' ; 
PAGEFORMAT DEFG2 
WIDTH (3) 
HEIGHT (4) 
DIRECTION DOWN ; 
LAYOUT 'def' ; 
PAGEFORMAT DEFG3 
WIDTH (3) 
HEIGHT (4) 
DIRECTION BACK ; 
LAYOUT 'ghi' ; 
PAGEFORMAT DEFG4 
WIDTH (3) 
HEIGHT (4) 
DIRECTION UP ; 
LAYOUT 'jki' ; 


Note: The parenthetical numbers represent dimensions. |Figure 45 on page 68] shows how these 


dimensions relate to the logical page. 


One page definition is used to simplify the example, yet four logical pages are specified. The 
PAGEFORMAT commands create subsets of page definitions for each logical page. 


Note: The page formats in this example require an Invoke Data Map structured field at the place in the 
data file where you want to change page formats. The LAYOUT commands are required but are not 
relevant in the example. 


The DIRECTION subcommand with one of its four direction parameters ACROSS, DOWN, UP, or BACK 
specifies the print direction of the logical page. 


Figure 46 on page 70}shows the format of each of the logical pages specified in the page definition with 


the direction specification of each. The pages with the ACROSS and BACK directions are in portrait 
presentation. The pages with the DOWN and UP directions are in landscape presentation. 
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Figure 46. Logical Page Print Directions in Relation to Origin 


The media origins and logical page origins do not change with the presentation of the data on the page. 
The OFFSET subcommand of the form definition need not change. However, the width and height 
dimensions do change; that is, the WIDTH subcommand always governs the horizontal (inline) dimension 
as you view the page, and the HEIGHT subcommand always governs the vertical (baseline) dimension 
whether the page is in portrait or in landscape presentation. Ensure that these specifications do not cause 
the logical page to cross the edge of the physical page. 


However, if the DOWN direction is specified for use with an IBM continuous forms printer, the PRESENT 
and DIRECTION subcommands may need to be specified in the form definition. See|“Specifying Page 
Presentation on Continuous-Forms Printers” on page 29}for more information. 

Using Margins in Record Formatting 


Margins follow the inline direction of the page. For example, if the text orientation is ACROSS, the top-left 
diagram in|Figure 47 on page 71|shows the left, top, right, and bottom margins, respectively. Once 
specified, these margins define a bounding box for the PAGEFORMAT as indicated by the dotted lines. 


Note that if the text orientation is changed, the same bounding box applies to the new orientation, but the 
name of the margins change in the new orientation. For example, if the new text orientation is DOWN, as 
shown in the top-right diagram of this same figure, the top margin in the new orientation is now defined on 
the long side of the page, and so on. 
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Figure 47. Relationship of Margin Definition to Text Orientation 
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Specifies the offset of the left margin along the i axis from the left edge of 
Specifies the offset of the top margin along the b axis from the top edge of 
the page. The top edge of the page is the zero position on the b axis. 


Specifies the offset of the right margin along the i axis from the right edge 


Specifies the offset of the bottom margin along the b axis from the bottom 
edge of the page. 


i <— Left Margin 
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Processing Fields 


This section describes the mapping of individual fields to the printed sheets. The technique allows you to 
print unformatted data according to precise specifications, and these specifications can change without 
affecting the data file. 


The rule for field processing of data files is: Each FIELD command must follow its associated LAYOUT 
command, and more than one FIELD command can be specified for a single LAYOUT command. 


For this field-processing example, the data file shown in|Figure 48) is used. |Figure 49 on page 73 


represents an output format that could be used to place data on a form, such as an invoice or an order. 
The page definition commands to print Figure 49 are as follows: 


PAGEDEF ABCD 
WIDTH 7 IN 
HEIGHT 8 IN ; 
FONT GS12 GS12; 
LAYOUT 'abc' POSITION 1 IN ABSOLUTE 1 IN ; /*PROCESSING FOR R1~ */ 
FIELD START 1 LENGTH 4 ; /*THE LAYOUT POSITION IS */ 
/*THE DEFAULT FOR THE FIRST FIELD*/ 
FIELD START 11 LENGTH 4 
POSITION 4 IN 0 IN ; 

LAYOUT 'def' POSITION 3 IN ABSOLUTE 4 IN ; /*PROCESSING FOR R2 */ 
FIELD START 1 LENGTH 4 ; /*DEFAULT POSITION */ 
FIELD START 6 LENGTH 4 

POSITION 0 IN 1 IN ; 
FIELD START 13 LENGTH 3 
POSITION 2 IN 3 IN ; 

LAYOUT 'ghi' POSITION 1 IN ABSOLUTE 2 IN ; /*PROCESSING FOR R3 */ 
FIELD START 1 LENGTH 4 ; /*DEFAULT POSITION */ 
FIELD START 11 LENGTH 4 

POSITION 4 IN 0 IN ; 


Note: The data area of this example does not show the Record ID. 


123 45 6 7 89 1. 2 Bh SB 
R1 JAJAJAIA B |B |B |B 
R2 |X{x|x|x} lYlylyly Z|z|z|z 
R38 J1) 111 2|2|2|2 
Data File 


Figure 48. Unformatted Print Data File 
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Figure 49. Data Arranged on the Printed Page 


Position Subcommand 


The POSITION subcommand of each LAYOUT command specifies the layout position relative to either the 
logical page origin or the previous LAYOUT position. The POSITION subcommands below FIELD 
commands specify a field position relative to the governing LAYOUT position. 


This is for use in positioning text, objects and graphics. If RELATIVE is specified or POSITION is not 
specified, the baseline of the Position is relative to the previous LAYOUT position. 


1. For PAGEHEADER LAYOUT the baseline position can be anywhere on a logical page. 


2. For PAGETRAILER, GROUPHEADER, and BODY LAYOUT the baseline position can be anywhere on 
a logical page and can be specified as RELATIVE. 


Following POSITION subcommands come the horizontal (x) then the vertical (y) offsets from the reference 
point. 

X Specifies the horizontal offset from the left side of the logical page. 

y Specifies the vertical offset from the top side of the logical page. 


They are parallel in structure to the OFFSET subcommand of the form definition. 


For example, the final POSITION subcommand on the previous example places the final field 1 + 4 
inches to the right of the left edge of the logical page, combining the x value of 1 in the LAYOUT 
command, and the x value of 4 in the nested FIELD command. The 0 in the FIELD command specifies no 
change to the y value in the LAYOUT command. Thus, the position of the final field is 5 IN (x), 2 IN (y). 


Note: The first FIELD command within each LAYOUT has no position specification, because the LAYOUT 
POSITION value is the default for the first FIELD command nested under it. 


Alternate controls for the x and y values of a POSITION subcommand are available. See the description of 
the POSITION subcommand in FIELD command (Record Format). 


FIELD Command as Used in this Example 


In the FIELD command, the START and LENGTH parameters specify the location of the field in the record 
to be processed. START indicates the starting byte position, and LENGTH specifies the number of bytes 
in the field. 
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setunits linesp 6 lpi; 
PAGEDEF rel9 replace yes 
direction across width 8.5 in height 11.0 in; 
FONT GS12 GS12; 
LAYOUT 'abc' position 0 IN 1.0 IN; 


/* The fields will be placed at +120 pels, +24 pels (next) */ 
/* and +48 pels (.20 IN) from lines previously placed on page */ 


setunits linesp 10 Ipi; 

LAYOUT 'def' position 0 relative next; 
FIELD START 1 LENGTH 3 position 0 IN .5 IN; 
FIELD START 4 LENGTH 3 position 0 IN next; 
FIELD START 7 LENGTH 3 position current .20 IN; 


Printing Lines in Two Directions on a Page 


Lines can be printed in any of four directions, depending on the type of printer being used. Refer to /BM 
Printing Systems: Printer Information for the print directions supported by your printer. 


The four parameters for line direction are ACROSS, DOWN, BACK, and UP. The PPFA commands used 
to format a line-data file with lines printed in more than one direction (as shown in|Figure 50) are stated in 
the following page definition: 


PAGEDEF ATOG 
DIRECTION ACROSS ; 
FONT GS12 GS12; 
LAYOUT 'abc' POSITION 1 IN ABSOLUTE 1 IN ; /*LINES A-E */ 
LAYOUT 'def' POSITION .5 IN ABSOLUTE 6 IN /*LINE F */ 
DIRECTION UP ; 
LAYOUT 'ghi' POSITION 1 IN ABSOLUTE 6 IN ; /*LINE G */ 


«—— 5in. ——» 

| | i | 
AAAAA || ae 
BBBBB -| BBBBB 
CCECCe Fin, ~|&CCCCC 
DDDDD aoe es 
-EEEEE. | - ,.DDDDD 
-FEEEE | _/HEEEEE 
GGGGG +GGGGG 

Data File 


Figure 50. A Printout with More Than One Line Direction 


Note: The data area of this example does not show the Record ID. 


In this page definition, the logical page direction ACROSS is specified. This is actually the default, but its 
inclusion clarifies that no direction control is needed for lines A—E. The default direction of a layout is the 
direction specification of the logical page of which it is part. The LAYOUT command for the record F has a 
DIRECTION subcommand because the direction specification changes from that of the previous line. 
Record G is to be printed in the ACROSS direction again. A direction is not specified, however, because 
the ACROSS direction is the default for all lines in this page definition. 


Printing Fields in Two Directions on the Same Page 


This example is similar to Printing Lines in Two Directions on a Page, except that you learn how to control 
direction field by field. This method creates a field-processing page definition and places direction controls 
in the FIELD commands. This command stream contains a portion of the page definition controls, showing 
only the LAYOUT commands: 
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LAYOUT 'abc' POSITION LEFTMARGIN TOPMARGIN NEWPAGE; 
FIELD START 1 LENGTH 4 ; 
LAYOUT 'def' POSITION 2 IN ABSOLUTE 4 IN ; 
FIELD START 7 LENGTH 4 
DIRECTION UP ; 


As expected in field processing, FIELD commands are nested within LAYOUT commands. [Figure 51] 
shows a simplified portion of an unformatted file and two pages of the printout formatted by the page 
definition, part of which is shown in the command stream. Two layouts are specified because the data file 
contains two input record formats (1 and 3 are alike; 2 and 4 are alike) and because the fields are mapped 
to two different positions in the output. The assumption of this sample is that the data file is actually much 
longer than the portion shown. If, however, the records in the file alternate in format as the first four do, 
the two LAYOUTs of this page definition format as many records as are presented, two to a page, on 
pages 1 through n. 


If more than two mappings are required by the print job, more than two LAYOUT commands are required 
in the page definition. 


Note: The data area of this example does not show the Record ID. 


<— 4in. —| «— 4in. —> 


er shes] bd 
123456789 1 RANK CCG 


R1 JAJAJAJA 
R2 B |B|B/B 


R3|Cicicic  — 
R4 DID/D/D ~ 


Figure 51. Field Direction 
Rn 


Varying Fonts ona Page 


This example illustrates a simple font variation within a printout. The task is to print a line-data file having 
the first line of each page in bold-faced type and the rest in standard type. This requires controls for two 
fonts in the page definition. 


The commands to select a single font for the page, as shown in|Figure 53 on page 76| are as follows: 


The FONT command contains two names: the local (STANDARD) name and the user-access (M101) 
name for the selected font. 


PAGEDEF ABCD ; 
FONT STANDARD M101; 
FONT BOLDFACE M102; 
LAYOUT 'abc' FONT BOLDFACE NEWPAGE; 
LAYOUT 'def' FONT STANDARD NEWPAGE; 
LAYOUT 'ghi' FONT STANDARD; 


BBBB 
|< 

| 

DDDD 


Page 1 Page 2... 


Note: Fonts cannot be an FGID (Font Typeface Global Identifier). (See page of the Glossary for 
additional explanation.) Also, all page definitions require a LAYOUT command. 


The following example shows line data using a single font: 
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def Record 1 
ghi Record 2 
ghi Record 3 
ghi Record 4 
ghi Record 5 
ghi Record 6 
def Record 7 
ghi Record 8 
ghi Record 9 
def Record 10 
ghi Record 11 
ghi Record 12 
ghi Record 13 


Figure 52. Line Data for Single Font Example 


Record 1 Record 7 Record 10 
Record 2 Record 8 Record 11 
Record 3 Record 9 Record 12 
Record 4 Record 13 
Record 5 
Record 6 

Page 1 Page 2 Page 3 


Figure 53. Data File Printed Using a Single Font 


This command stream works on the principle that each line of output whose font you want to change from 
the font in the previous line must be controlled by a separate LAYOUT command. The FONT 
subcommand of the LAYOUT command names the font desired for that line. In this example, two LAYOUT 
commands are used because one font change and two fonts are intended for the output. The user-access 
font names appear in the two FONT commands immediately below the PAGEDEF command and, 
optionally, a local name. M101 and M102 in the example are user-access names; BOLDFACE is a local 
name. Use the local name in the FONT subcommand of LAYOUT if it is included in the corresponding 
FONT command, as is done for the first LAYOUT command. 


abc Record 1 
ghi Record 2 
ghi Record 3 
ghi Record 4 
ghi Record 5 
ghi Record 6 
abc Record 7 
ghi Record 8 
ghi Record 9 
abc Record 10 
ghi Record 11 
ghi Record 12 
ghi Record 13 


Figure 54. Line Data for Two Font Example 
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Bold Face 


Record 7 —— 10 


Record 1 
Record 2 Record 8 Record 11 
Record 3 Record 9 Record 12 
Record 4 Record 13 
Record 5 
Record 6 

Page 1 Page 2 Page 3 


Figure 55. Font Change Using FONT Commands and Subcommands 


Changing fonts field by field is similar to changing them in layouts. You map each field individually with a 
FIELD command; include a FONT subcommand in the FIELD command. If a font change is desired for a 
field, as with the FONT subcommand of a LAYOUT command, the font must be previously named in a 
FONT command. 


Rotating Fonts 


Fonts rotate relative to the inline direction of lines (or fields). 


This example focuses on a single letter A from FONTA. With PPFA, a single font specified in a page 
definition can produce letters in any of four rotations. This is accomplished by a FONT command that 
specifies rotation. If, as in this example, you want to vary the rotation of a font twice within a page, you 
use two FONT commands, one for each rotation. You also use two LAYOUT commands to map the data 
to the printout, using the two rotations of the font. In a field processing application, FIELD commands can 
be used in the same way. These LAYOUT commands name the rotated font in a FONT subcommand. 


[Figure 56] breaks down the elements required for the FONT commands and subcommands. Distinct local 
names and rotation specifications for each font are placed in a FONT command. These identify a font as 
rotated within a page definition. The rotation of a character is relative to the inline direction of a field or 
LAYOUT. The characters and rotations shown here assume an inline direction of ACROSS. 


FONT command Name Rotation 
Figure 56. Character Rotation 


Local Name 1 Rotation O A 0° 
Local Name 2 Rotation 90 > ° 90° 
User-access Rotati 180 y 270 
Local Name 3 name otation 
Local Name 4 Rotation 270 < 180° 
v 


FONT subcommand, FIELD command 


You can use up to 16 possible combinations of logical page direction and font rotation for page printers 
other than the 3800. 
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The FONT subcommands within LAYOUT or FIELD commands that name the rotated font in that page 
definition use only the local name. The following command stream shows the proper specification and 
nesting of FONT commands and subcommands for rotation. 


PAGEDEF ABCD ; 


FONT FONTA M103 ; /*NO ROTATION, LOCAL AND / 
/*USER-ACCESS NAMES. */ 
FONT FONTARTD180 M103 /*ROTATED FONT, LOCAL, USER-ACCESS*/ 
ROTATION 180 ; /*NAMES PLUS ROTATION SUBCOMMAND  */ 
/*AND PARAMETER. */ 
LAYOUT ‘abc! FONT FONTA ; /*LOCAL NAME / 
LAYOUT ‘def! FONT FONTARTD180 ; /*LOCAL NAME */ 

AAAA 

AAAA 

AAAA 

VVVV 

VVVV 


Figure 57. Example of Assumed Data File and Rotation Specifications 


FONTA, identified in the first FONT command, requires no rotation parameter because it is printed in the 
default position (or 0° rotation) for font M103. For the rotated font, the second FONT command identifies 
FONTARTD180 (the local name) as M103 rotated 180°. 


Using Traditional Kanji Formatting 


Traditional kanji print presentation, called tate, is possible with your print server printers, using a 
combination of font rotation and logical page direction. A logical page in the DOWN direction and a 270° 
font rotation provide the right combination to present kanji in tate format on a print server printer. 


FORMDEF TATE 
OFFSET 1 IN 1 IN ; 
PAGEDEF TATE 
HEIGHT 5 IN 
WIDTH 6 IN 
DIRECTION DOWN ; 
FONT KANJIRTD M104 
ROTATION 270 ; 
LAYOUT 'tate' FONT KANJIRTD; 


Figure 58 on page 79}shows the result of formatting with the above page definition. The characters are 


added to lines down the page. Lines are added right to left. 
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Logical Page in Direction Character Rotation 270° 


| Down 

Hardware Hardware 7 

Origin Origin LLL 270° 
| 

i fo) 

NNN 180 0 
EEE 
32] 90° 


Figure 58. AFP Printer Tate Presentation 


Record Formatting Examples 


In order to allow different formats for different groups (or tables) of data, each of which have an 
unpredictable number of entries, a Record ID is assigned to each output record to identify the type of 
record and control layout formatting. An application can group data fields that are to be formatted together 
as an entity into Data Records with a specific Record ID. For example, in a bank statement, the data fields 
for a check transaction might be grouped together with a Record ID identifying that record as a check 
transaction. The PAGEDEF would then define a special layout format for a check transaction with a 
matching Record ID. 


The same thing could be done for a deposit transaction, customer account information, deposit totals, 
check totals, etc. If the customer account information is going to be used in a page header on each page, 
the PAGEDEF can define a special layout format for a customer information record that automatically 
generates a page header for each page. 


This section shows two complete examples using the record formatting process. Each is divided into three 
parts - the desired output (after PAGEDEF processing), the application output (before PAGEDEF 
processing), and the PPFA commands. 


Note: The source and data for these examples can be located on IBM Printing Systems WEB site: 
http://www. ibm.com/printers.R5PSC.NSF/web/ppfa 


Once the WEB site has been displayed, then select the option titled “PPFA Record Formatting 
Description”. 


Example 1 Desired Output (after PAGEDEF Processing) 


The example user data along with the PPFA commands are meant to create this printed output. (The 
following page has been resized to fit the format of this User’s Guide.) 
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Big Brother Bank 
“We watch over you” 
P.O. Box 1573 

Beantown, MA 02116 


Justin Case 
123 Redlight Lane 
TwistNshout, MA 02345 


Super Checking Account Activity 


Beginning Balance Credits 
2591. 24 1946. 93 


Credits Description Date 


Account Number: 


Statement Begin Date: 
Statement End Date: 


Debits Service Charge 


1956. 43 0. 00 


Amount 


DEPOSIT 01/05/02 26. 90 
AUTO DEPOSIT 01/15/02 954.27 
AUTO DEPOSIT 01/30/02 954.27 
INTEREST 01/31/02 11. 49 


Total Credits 
Checks Check No. Date 


01/04/02 
01/10/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 
01/15/02 


Amount Check No. 


$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 


Date 


01/05/02 
01/11/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 
01/30/02 


026-257311 
JAN 02, 2002 
FEB 01, 2002 


Ending Balance 
2081. 72 


Figure 59. Part one of Sample Graphic Created by the Following User Data and PPFA Commands. 
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Big Brother Bank 


“We watch over you” Account Number: 026-257311 
P.O. Box 1573 Statement Begin Date: JAN 02, 2002 
Beantown, MA 02116 Statement End Date: FEB 01, 2002 


Justin Case 
123 Redlight Lane 
TwistNshout, MA 02345 


Checks Check No. Date Check No. Date Amount 


01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
01/15/02 01/30/02 
Total Checks 


EEOC EE HOHE SES 
G9 GO 0 GG 0 09 FO 09 0 0 
DAMHAANMMAHHHMNNOH 


= 
on 
[o>) 


Daily Date Balance Balance 


Balances 
01/04/02 $2269. 74 01/05/02 $2196. 64 
01/10/02 $2074. 34 01/11/02 $2014. 39 
01/15/02 $2016. 33 01/30/02 $2570. 25 


Final Balance $2581 . 74 


Interest Rate as of 01/04 * * * 5.321% 


Figure 60. Part two of Sample Graphic Created by the Following User Data and PPFA Commanads.. 
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Example 1 Application Output (before PAGEDEF Processing) 


Each layout record contains all information for a given layout. Because of lack of space, only the first 80 
bytes are shown here. The first 10 characters must contain the layout id. 


11111111112222222222333333333344444444445555555555666666666677777777778 
12345678901234567890123456789012345678901234567890123456789012345678901234567890 
statmid 026-2573llJustin Case 123 Redlight Lane Twistnshout MA 02345 
statsum $2591.24 $1946.93 $1956.43 $0.00 $2581.72 
pgenum 
crheader 
crdata DEPOSIT @1/05/02 $ 26.90 
crdata AUTO DEPOSIT 01/15/02 $ 954.27 
crdata AUTO DEPOSIT 01/30/02 $ 954.27 
crdata INTEREST @1/31/02 $ 11.49 


crtotal $1946.93 
ckheader 

ckdatal 352 01/04/02 $ 321.50 
ckdatar 353 01/05/02 $ 100.00 
ckdatal 354 01/10/02 $ 122.30 
ckdatar 355 @1/11/02 $ 59.95 
ckdatal 356 01/15/02 $ 852.33 
ckdatar 357 @1/30/02 $ 500.35 
ckdatal 358 01/15/02 $ 852.33 
ckdatar 359 01/30/02 $ 500.35 
ckdatal 360 01/15/02 $ 852.33 
ckdatar 361 @1/30/02 $ 500.35 
ckdatal 362 01/15/02 $ 852.33 
ckdatar 363 01/30/02 $ 500.35 
ckdatal 364 01/15/02 $ 852.33 
ckdatar 365 01/30/02 $ 500.35 
ckdatal 366 01/15/02 $ 852.33 
ckdatar 367 01/30/02 $ 500.35 
ckdatal 368 01/15/02 $ 852.33 
ckdatar 369 01/30/02 $ 500.35 
ckdatal 370 01/15/02 $ 852.33 
ckdatar 371 @1/30/02 $ 500.35 
ckdatal 372 01/15/02 $ 852.33 
ckdatar 373 01/30/02 $ 500.35 
ckdatal 374 01/15/02 $ 852.33 
ckdatar 375 Q1/30/02 $ 500.35 
ckdatal 376 01/15/02 $ 852.33 
ckdatar 377 Q1/30/02 $ 500.35 
ckdatal 378 01/15/02 $ 852.33 
ckdatar 379 01/30/02 $ 500.35 
ckdatal 380 01/15/02 $ 852.33 
ckdatar 381 Q1/30/02 $ 500.35 
ckdatal 382 01/15/02 $ 852.33 
ckdatar 383 01/30/02 $ 500.35 
ckdatal 384 01/15/02 $ 852.33 
ckdatar 385 01/30/02 $ 500.35 
ckdatal 386 01/15/02 $ 852.33 
ckdatar 387 01/30/02 $ 500.35 
ckdatal 388 01/15/02 $ 852.33 
ckdatar 389 01/30/02 $ 500.35 
ckdatal 390 01/15/02 $ 852.33 
ckdatar 391 Q1/30/02 $ 500.35 
ckdatal 392 01/15/02 $ 852.33 
ckdatar 393 01/30/02 $ 500.35 
ckdatal 394 01/15/02 $ 852.33 
ckdatar 395 01/30/02 $ 500.35 
ckdatal 396 01/15/02 $ 852.33 
ckdatar 397 01/30/02 $ 500.35 
ckdatal 398 01/15/02 $ 852.33 
ckdatar 399 01/30/02 $ 500.35 
ckdatal 400 01/15/02 $ 852.33 
ckdatar 401 Q1/30/02 $ 500.35 
ckdatal 402 01/15/02 $ 852.33 
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ckdatar 
ckdatal 
ckdatar 
ckdatal 
ckdatar 
ckdatal 
ckdatar 
ckdatal 
ckdatar 
ckdatal 
ckdatar 
ckdatal 
ckdatar 
ckdatal 
ckdatar 
ckdatal 
ckdatar 
cktotal 
balhead 

baldatal 
baldatar 
baldatal 
baldatar 
baldatal 
baldatar 
baltotal 
statrail 


403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 


01/30/02 
01/15/02 
01/30/02 
01/15/02 
01/30/02 
Q1/15/02 
01/30/02 
01/15/02 
01/30/02 
01/15/02 
01/30/02 
01/15/02 
01/30/02 
01/15/02 
01/30/02 
01/15/02 
01/30/02 


01/04/02 
01/11/02 
01/05/02 
01/15/02 
01/10/02 
01/30/02 
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$ 500. 
$ 852. 
$ 500. 
$ 852. 
$ 500. 
$ 852. 
$ 500. 
$ 852. 
$ 500. 
$ 852. 
$ 500. 
$ 852. 
$ 500. 
$ 852. 
$ 500. 
$ 852. 
$ 500. 
$1956. 


$2269. 
$2014. 
$2196. 
$2116. 
$2074. 
$2570. 
$2581. 
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Example 1 PPFA Commands 


PAGEDEF justin replace yes 
WIDTH 8.5 in 
HEIGHT 11.0 in; 
FONT comp a075nc ; /*Big Brother Bank font */ 


FONT ital al75dc ; /*Italic theme */ 
FONT addr aQ75dc ; /*Big Brother address */ 
FONT varb gtlQ 3; /*Variable data */ 
FONT super aO75dc ; /*Super Checking Account */ 
FONT head a055ac; /*Headings */ 
FONT bhead a075ac; /*Bold Headings */ 


PAGEFORMAT chubl TOPMARGIN 2 in BOTMARGIN 2 in; 
[RHR KKK RK KK EAA KKK KKK KKK KKK KKK KEK KEK K KERR ERK | 
/** statmid BODY x*/ 
[KEK KKK RAK KEIR K ERK KER KK ERK K KEK KEKE KK KER ARERR | 
LAYOUT C'statmid' PAGEHEADER NEWPAGE 
POSITION .6 in ABSOLUTE .55 in; 
FIELD TEXT C'Big Brother Bank' ALIGN LEFT 
FONT comp ; /* default to LAYOUT positioning*/ 
FIELD TEXT C'"We watch over you"! ALIGN LEFT 
POSITION 0 NEXT 
FONT ital ; /*default to next line */ 
FIELD TEXT C'P.O. Box 1573' ALIGN LEFT 
POSITIO 0 NEXT 
FONT addr ; /*default to next line */ 
FIELD TEXT C'Beantown, MA 02116' ALIGN LEFT 
POSITION 0 NEXT 
FONT addr ; /*default to next line */ 
FIELD TEXT C'Account Number:' ALIGN LEFT 
POSITION 4.3 in .2 in 
FONT head ; /*New area on right */ 
FIELD TEXT C'Statement Begin Date:' ALIGN LEFT 
POSITION 4.3 in NEXT 
FONT head ; /*New area on right */ 
FIELD TEXT C'Statement End Date:' ALIGN LEFT 
POSITION 4.3 in NEXT 
FONT head ; /*New area on right */ 
FIELD START 1 LENGTH 10 ALIGN RIGHT 
POSITION 7.5 in .2 in 
FONT varb ; /*variable - account numberx/ 
FIELD START 75 LENGTH 12 
POSITION 7.5 in EXT 
ALIGN RIGHT /* data is missing from example */ 
FONT varb ; /*variable - begin date */ 
FIELD START 88 LENGTH 12 
POSITION 7.5 in’ NEXT 
ALIGN RIGHT /* data is missing from example */ 
FONT varb ; /*variable - end date */ 
FIELD START 11 LENGTH 19 ALIGN LEFT 
POSITION 1.1 in .9 in 
FONT varb ; /*variable - customer name */ 
FIELD START 30 LENGTH 19 ALIGN LEFT 
POSITION 1.1 in NEXT 
FONT varb ; /*variable - customer address */ 
FIELD START 49 LENGTH 22 ALIGN LEFT 
POSITION 1.1 in NEXT 
FONT varb ; /*variable - customer city, st. */ 


[KERR KKK K KEK KKK KKK KKK KKK KKK KKK KEKE AK KEK KERR | 
/** statsum BODY x*/ 
[ REKR KEI K KEIR KEK KKK KEK KKK K KKK KKK K KER ARERR | 
LAYOUT C'statsum' BODY 

POSITION .6 in .5 in; 

FIELD TEXT C'Super Checking Account Activity' 
FONT super ; /* Static text - Super Checking */ 
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DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 

POSITION @ .15 in 

copy down 2 spaced 1 mm; 

FIELD TEXT C'Beginning Balance’ 

POSITION .3 in .4 in 

FONT head ; /* Static text - first header */ 

FIELD TEXT C'Credits' 

POSITION 2.4 in CURRENT 

FONT head ; /* Static text - first header */ 

FIELD TEXT C'Debits' 

POSITION 3.6 in CURRENT 
FONT head ; /* Static text - first header */ 
FIELD TEXT C'Service Charge' 

POSITION 4.8 in CURRENT 

FONT head ; /* Static text - first header 
FIELD TEXT C'Ending Balance’ 

POSITION 6.3 in CURRENT 


FONT head ; /* Static text - first header */ 


FIELD START 1 LENGTH 8 

POSITION .6 in .6 in 

FONT varb ; /* Variable text - Beg balance 
FIELD START 10 LENGTH 8 

POSITION 2.2 in CURRENT 

FONT varb ; /* Variable text - Credits 

FIELD START 20 LENGTH 8 

POSITION 3.4 in CURRENT 

FONT varb ; /* Variable text - Debits 
FIELD START 30 LENGTH 5 

POSITION 5.0 in CURRENT 


FIELD START 40 LENGTH 8 
POSITION 6.5 in CURRENT 
FONT varb ; /* Variable text - End Balance 

DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION © .7 in; 


[BERR K ERA RRA K KEK KKK IKKE IKKE AKER KEE AK KEK K ERE | 
/** crheader GROUPHEADER x*/ 
[RRR RK RRA KKK KKK KK KA KKK KKK KKK EK KEE AK KEKE KER | 
LAYOUT C'crheader' GRPHEADER XSPACE .2 in 
POSITION SAME .9 in; 
FIELD TEXT C'Credits' 
FONT bhead ; /* Static text - Credits */ 
FIELD TEXT C'Description' 
POSITION 1.3 in CURRENT 
FONT head ; /* Stat text - Deposit Descr. */ 
FIELD TEXT C'Date' 
POSITION 3.2 in CURRENT 
FONT head ; /* Static text - Date */ 
FIELD TEXT C'Amount' 

POSITION 5.0 in CURRENT 
FONT head ; /* Stat text - Amount of deposit*/ 
DRAWGRAPHIC LINE ACROSS 6.2 IN LINEWT BOLD 
POSITION 1.3 in next; 


[RRR KKK RAK KR AK KKK KK KKK KKK KKK AK KEK KEE AK KIA K KEKE | 
/** crdata BODY x / 
[KERR KKK KK EA KKK KKK KK KIRKE KKK KEK KER AK KEK ARE KE | 
LAYOUT C'crdata' BODY GROUP; 
FIELD START 1 LENGTH 13 

POSITION 1.3 in CURRENT 
FONT varb ; /* Variable text - Description */ 
FIELD START 14 LENGTH 8 

POSITION 3 in CURRENT 
FONT varb ; /* Variable text - Date */ 
FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 5.6 in CURRENT 
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*/ 


*/ 


*/ 


FONT varb ; /* Variable text - Service Chrg */ 


*/ 
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FONT varb ; /* Variable text - Amount */ 


[BRK RRR A KK EAR KEK KK ERK KEK KEK A KKK KEKE KEKE ARERR | 
/** crtotal BODY x«/ 
[KEK KK KKK KK EAA KIRKE K KKK K KKK KKK KEK K KEK KERKK | 
LAYOUT C'crtotal' BODY GROUP; 
FIELD TEXT C'Total Credits' 
POSITION 1.5 in 2 in 

FONT bhead ; /* Stat text - Total credits x/ 
FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 7.3 in CURRENT 

FONT varb ; /* Variable text - Amount */ 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION 0 next; 


[BRK R KEIR KEIR KE KK KEKE K KEK KEK KKK KEKE RARER EKER | 
/** ckheader GROUPHEADER «x / 
[BRK RRR A KK EA KK ERK KKK KEK KKK KKK KEKE KEKE ARERR | 
LAYOUT C'ckheader' GRPHEADER XSPACE .2 in 
POSITION SAME .6 in; 
FIELD TEXT C'Checks' 
FONT bhead ; /* Static text - Checks x/ 
FIELD TEXT C'Check No.' 
POSITION 1.4 in CURRENT 

FONT head ; /* Stat text - Check number x/ 
FIELD TEXT C'Date' 

POSITION 2.5 in CURRENT 
FONT head ;/* Stat text - Date of check */ 
FIELD TEXT C'Amount' 

POSITION 3.5 in CURRENT 
FONT head ;/* Static text - Amount of checkx/ 
FIELD TEXT C'Check No.' 

POSITION 4.6 in CURRENT 
FONT head ; /* Stat text - Check number x/ 
FIELD TEXT C'Date' 

POSITION 5.6 in CURRENT 
FONT head ;/* Stat text - Date of check */ 
FIELD TEXT C'Amount' 

POSITION 6.8 in CURRENT 
FONT head ;/* Static text - Amount of checkx/ 
DRAWGRAPHIC LINE ACROSS 6.2 IN LINEWT BOLD 
POSITION 1.3 in next; 
DRAWGRAPHIC LINE DOWN LINETYPE shortdash 
POSITION 4.5 in CPOS; 


[BRK R KEIR KEIR K EK KKK KKK KEK KKK EKER EKER ARERR | 
/** ckdatal BODY left side «x / 
[ REK RK KKK KEK KK RAK KKK KKK KKK KKK KEKE KK KEK KERR | 
LAYOUT C'ckdatal' BODY GROUP 

POSITION SAME NEXT; 

FIELD START 2 LENGTH 3 

POSITION 1.4 in CURRENT 


FIELD START 14 LENGTH 8 
POSITION 2.4 in CURRENT 
FONT varb ; /* Variable text - Date 
FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 4.4 in CURRENT 
FONT varb 3; /* Variable text - Amount */ 


[RRR KERR KK EAA KAR KEIR KEK KKK KKK KKK EK KKK KERR | 
/** ckdatar BODY right side xx / 
[BERR KEK K KEI K KEK KER KKK KKK KEK AKER EKER AKER AREER | 
LAYOUT C'ckdatar' BODY GROUP 
POSITION SAME SAME; 

FIELD START 2 LENGTH 3 
POSITION 4.6 in CURRENT 
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FONT varb ; /* Variable text - Check number */ 


*/ 


FONT varb ; /* Variable text - Check number */ 
FIELD START 14 LENGTH 8 
POSITION 5.6 in CURRENT 
FONT varb ; /* Variable text - Date */ 
FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 7.5 in CURRENT 
FONT varb ; /* Variable text - Amount */ 


[RRR RK KAR KR AK KEK K KEI KKK AKIRA KKK KER IKKE KKK | 
/** cktotal BODY x*/ 
[KERR KKK KK AK KEK KKK IKKE IK KKK A KKK KER AK KAKA KEKE | 
LAYOUT C'cktotal' BODY GROUP; 
ENDGRAPHIC LPOS; /*ends dashed line between checks */ 
FIELD TEXT C'Total Checks' 
POSITION 1.5 in .2 in 

FONT bhead ; /* Stat text - Total checks */ 
FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 7.3 in CURRENT 

FONT varb ; /* Variable text - Amount */ 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION OQ next; 


[KERR KKK KKK KKK KKK AK KKK KKK K KEK KER AK KEK KKK KK | 
/** balhead GROUPHEADER xx/ 
[RRR RK KKK KR AK KEK KKK IKKE IKKE KKK KEK KEE AK KEK EKER KK | 
LAYOUT C'balhead' GRPHEADER XSPACE .2 in 
POSITION SAME .6 in; 
FIELD TEXT C'Daily' 
FONT bhead ; /* Static text - Daily Balance */ 
FIELD TEXT C'Date' 
POSITION 1.3 in CURRENT 
FONT head ;/* Stat text - Date of balance */ 
FIELD TEXT C'Balance' 
POSITION 2.8 in CURRENT 
FONT head ;/* Static text - Balance */ 
FIELD TEXT C'Date' 
POSITION 4.3 in CURRENT 
FONT head ; / Stat text - Date of balance */ 
FIELD TEXT C'Balance' 
POSITION 5.8 in CURRENT 
FONT head ; /*Static text - Balance */ 
FIELD TEXT C'Balances' 
POSITION O NEXT 
FONT bhead ; /*Static text - Daily Balance */ 
DRAWGRAPHIC LINE ACROSS 6.2 IN LINEWT BOLD 
POSITION 1.3 in CPOS; 


[KERR KKK KER AK KKK KK KIRKE IK KKK K KEK KEE AK KEKE KEKE | 
/** baldatal BODY left side xx / 
[BERR KER A KK AK KEK KEE AKER KEK IKKE AKER IKKE KARE | 
LAYOUT C'baldatal' BODY GROUP 
POSITION SAME NEXT; 
FIELD START 14 LENGTH 8 
POSITION 1.3 in CURRENT 
FONT varb ; /* Variable text - Date */ 

FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 3.6 in CURRENT 
FONT varb 3; /* Variable text - Amount */ 


[BRK K ERA KKEAK KEK KEK IKKE AK KEK AK K EA KEE AK KEKE REREKE | 
/** baldatar BODY right side «x / 
[KERR KKK K KR AK KEK K KEIR KKK KKK AK KEK KEE AK KE AK KEKE KE | 
LAYOUT C'baldatar' BODY GROUP 
POSITION SAME SAME; 

FIELD START 14 LENGTH 8 
POSITION 4.3 in CURRENT 

FONT varb ; /* Variable text - Date */ 
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FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 6.6 in CURRENT 
FONT varb ; /* Variable text - Amount */ 


[KEK KKK KKK EK KKK KKK IKK KKK KKK KKK KKK AKER REE | 
/** baltotal BODY xx / 
[KEK KKK AKK EAR KEK KK EKA KEK KKK KEE KK KEK AKER AKER | 
LAYOUT C'baltotal' BODY GROUP; 
FIELD TEXT C'Final Balance' 
POSITION 1.5 in .2 in 

FONT bhead ; /* Stat text - Final balance */ 
FIELD START 24 LENGTH 8 ALIGN RIGHT 
POSITION 7.3 IN CURRENT 

FONT varb 3; /* Variable text - Amount */ 


[BERR KEIR KEIR KEK KK ERK K KKK KE KKK KEK KEKE KER ARERR | 

/** statrail BODY xx / 

[BRK KKK AK KEA KKK KK ERK KEK KEE K KKK KEKE AKER EKER | 
LAYOUT C'statrail' BODY 

POSITION SAME .4 in; 

DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 

POSITION 0 CPOS; 

FIELD TEXT C'Interest Rate ' 

POSITION 2.0 in NEXT 

FONT bhead ; /* Static text - Interest rate */ 
FIELD TEXT C'As of 01/04 * * * 5.321%! 

POSITIO CURRENT CURRENT 

FONT varb ; | /* Static text */ 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 

POSITION 0 NEXT 

copy down 2 spaced 1 mm; 


[KEK KKK KKK EA KKK KKK KKK KKK KKK KKK KKK KKK K ERK | 
/** pgenum PAGE NUMBER xx / 
[BRK R KKK KK EAR KEK KK EKER KEK KKK KEKE KEKE ARERR | 
LAYOUT C'pgenum' PAGETRAILER 

POSITION SAME ABSOLUTE 10.7 in; 

FIELD TEXT C ‘Page ' 

POSITION 6.5 in CURRENT 


FONT varb;/* placement of page number x/ 
FIELD PAGENUM PRINT RESET 1 /* request page numbering*/ 
FONT varb /* placement of page number */ 


POSITION CURRENT CURRENT; 
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Example 2 Using Repeated and Unended Boxes 


This example shows how to use the repeated box option, a single circle and some unended boxes. (The 
following example has been resized to fit the format of this User’s Guide.) 


01/04/02 
01/05/02 
01/10/02 
01/11/02 
01/15/02 
01/30/02 


Justin Case 
123 Redlight Lane 
Twistnshout, MA 02345 


__Date:_[eheckne| _Payebiete:_} ann 


WalMart 

Sears 

Boulder Bookstore 
Kathy‘s Pretty Things 
Pirie Racing Enterprises 
Rockley‘’s Music Center 


Figure 61. Example Showing How to Use the Repeating Box Option 


Example 2 Application Output (before PAGEDEF Processing) 


11111111112222222222333333333344444444445555555555666666666677 
12345678901234567890123456789012345678901234567890123456789012345678901 


statmid 
ckheader 
ckdata 
ckdata 
ckdata 
ckdata 
ckdata 
ckdata 
ckend 


Justin Case 


352 
353 
354 
355 
356 
357 


123 Redlight Lane Twistnshout MA 02345 


01/04/02 
01/05/02 
01/10/02 
01/11/02 
01/15/02 
01/30/02 


$ 321.50 WalMart 

$ 100.00 Sears 

$ 122.30 Boulder Bookstore 

$ 59.95 Kathy's Pretty Things 

$ 852.33 Pirie Racing Enterprises 
$ 500.35  Rockley's Music Center 


PPFA Input for Repeated Boxes Example 2 


PAGEDEF reptl 


FONT 
FONT 
FONT 


PAGEFORMAT 


replace yes; 


addr a075dc ; 


varb gt10 


bhead aQ75ac; 
SETUNITS LINESP .25 in ; 


SEGMENT ibmlog; 


[BERR KKK KK EA KKK K KER AKEKKK KKK KEK KEKE KKK ER ARERR | 


reptl 


BOTMARGIN 


/*customer address */ 
/*Variable data */ 
/*Bold Headings */ 
/* Line spacing */ 
2 ins 

/*IBM logo */ 
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/** statmid PAGEHEADER xe / 
[KEK ARK K KEIR KER AKER A KEK KEK IKKE KK KEK AKER AKER | 
LAYOUT C'statmid' 
SEGMENT ibmlog 1.15 in 1.35 in 
PAGEHEADER NEWPAGE 
POSITION SAME ABSOLUTE NEXT; 
DRAWGRAPHIC CIRCLE RADIUS .5 in /* 1 inch circle 
POSITION 1.5 in 1.5 in; 
DRAWGRAPHIC BOX BOXSIZE 2.6 IN .25 IN ROUNDED LARGE 


*/ 


LINEWT 0 /* invisible border «/ 


POSITION 4 IN 1 IN 
COPY DOWN 2 SPACED 0 
FILL ALL DOTO2; 
FIELD START 2 LENGTH 19 ALIGN LEFT 
POSITION 4.2 in 1.2 in 
FONT addr ; /*variable - customer name */ 
FIELD START 21 LENGTH 19 ALIGN LEFT 
POSITION 4.2 in NEXT 
FONT addr ; /*variable - customer address «/ 
FIELD START 40 LENGTH 22 ALIGN LEFT 
POSITION 4.2 in NEXT 
FONT addr ; /*variable - customer city, st. */ 
[KEK KKK ERK K ERK KER AKER KK KEK KKK KEK KK EKA KEK AKER KK | 
/** ckheader GROUPHEADER «x / 
[RRR KKK ARK AK KER AKER A KKK KKK KKK KEK K KEK K KER | 
LAYOUT C'ckheader' GRPHEADER XSPACE .25 in 
POSITION 1 in ABSOLUTE 2.5 in; /* set position 
DRAWGRAPHIC BOX BOXSIZE .95 IN .3 IN 
POSITION 0 Q; 


*/ 


DRAWGRAPHIC BOX BOXSIZE .95 IN /* box started for data 


POSITION 0 «3 in? 
FIELD TEXT C'Date' 
POSITION 3 in 2 in 
FONT bhead ; /* Stat text - Date of check */ 
DRAWGRAPHIC BOX BOXSIZE .8 IN .3 IN 
POSITIO 95 IN 0; 


/* no vertical size */ 


DRAWGRAPHIC BOX BOXSIZE .8 IN /* box started for data 


POSITION .95 in .3 in; 
FIELD TEXT C'Check No.' 
POSITION 1 in .2 in 
FONT bhead ; /* Stat text - Check number */ 
DRAWGRAPHIC BOX BOXSIZE 3 IN .3 IN 
POSITION 1.75 IN Q3 
DRAWGRAPHIC BOX BOXSIZE 3 IN 
POSITION 1.75 in’ .3 in; 
FIELD TEXT C'Payable to:' 
POSITION 2.9 in 2 in 
FONT bhead ; /* Static text - Payable to: */ 
DRAWGRAPHIC BOX BOXSIZE .95 IN .3 IN 
POSITION 4.75 IN 0 in; 


/* no vertical size 


/* no vertical size 


/* box started for data 


DRAWGRAPHIC BOX BOXSIZE .95 in /* box started for data 


POSITION 4.75 in .3 in; 
FIELD TEXT C'Amount' 
POSITION 5 in .2 in 
FONT bhead ; /* Stat text - Amount of check */ 
[RRR KKK ARK ERK KER AKER AKER KKK KKK KKK AKER AKER KK | 
/** ckdata BODY w/ un-ended boxes x*/ 
[RRR KKK KKK ERK KER KKK KKK KKK KKK KEK KK EKA KEK KEK | 
LAYOUT C'ckdata' BODY GROUP; 
FIELD START 2 LENGTH 3 ALIGN LEFT 
POSITION 1.2 in CURRENT 
FONT varb ; /* Variable text - Check number */ 
FIELD START 14 LENGTH 8 ALIGN LEFT 
POSITION .1 in CURRENT 
FONT varb ; /* Variable text - Date */ 
FIELD START 35 LENGTH 25 ALIGN LEFT 
POSITION 2.0 in CURRENT 


/* no vertical size 


PPFA User’s Guide 


*/ 
*/ 


*/ 
*/ 


*/ 
*/ 


FONT varb ; /* Variable text - Payable to: */ 
FIELD START 24 LENGTH 8 ALIGN RIGHT 


POSITION 5.6 in 


CURRENT 


FONT varb ; /* Variable text - Amount */ 


[RRR K KERR KK ER KKK KKK KKK KKK KKK KKK KK EKA KEK K KEKE | 


/** ckend BODY to end boxes 


[BERR KKK KEKE IKKE AK KEK A KEKE KKK KEK KEKE KEKE ARERR | 


LAYOUT C'ckend' BODY GROUP; /* 


ENDGRAPHIC LPOS; 


/* 
/* 
/* 
/* 
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*x*/ 


If this layout and command are 
not issued, the boxes should be 
closed anyway. But if there was 
a trailer, they may not end in 
the right place. 


*/ 
*/ 
*/ 
*/ 
*/ 
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XML Page Definition Formatting Function 


The XML page definition formatting function allows an application to specify formatting instructions for XML 
data by specifying an XLAYOUT command with specific formatting instructions for the data. The 
XLAYOUT command addresses an XML data item by specifying a QTAG (qualified tag) for that data. A 
QTAG is a series of XML start tags that fully identify the XML data item. For example, in|Figure 62 on] 


page 93} for your customer’s first name, the QTAG would be Customer, name, and first. To define a local 


name “first” for easy reference you could use the following DEFINE command: 
DEFINE first QTAG 'Customer','name','first'; 


and reference it with the following XLAYOUT command using the defined local name “first”: 
XLAYOUT first POSITION ...; 


Before printing the data, PSF scans the XML data item and matches it to an XLAYOUT command in the 
page definition by using its QTAG. The matching XLAYOUT command in the page definition is used to 
position and format the associated XML data item and its attributes on the printed page. 


The XML page definition function has the following new PPFA concepts: 


Relative Inline Positioning: 
Relative inline positioning places data relative to the current position. If you position a text field 
and then place the text, the end of the text becomes the new current position. Graphics, barcodes, 
objects, segments, and overlays do not change the current position after they are originally 
positioned. For example, if you position a line with a DRAWGRAPHIC LINE command, the new 
current position is the starting point of that line. The length of the graphic line does not change the 
current position. 


There are several restrictions when using relative inline positioning: 


1. XLAYOUT commands with relative positioning cannot contain any of the following: 
* FIELD commands with inline positioning relative to the XLAYOUT (LPOS) 
¢ FIELD ATTR (attribute) with inline positioning relative to the XLAYOUT (LPOS) 
¢ FIELD commands with barcodes 
* DRAWGRAPHIC commands 
* OBJECT subcommands 
* SEGMENT subcommands 
* OVERLAY subcommands 


2. You can only use the SAME parameter for inline positioning on the XLAYOUT command when 
the previously used XLAYOUT command used absolute inline positioning. 


Absolute Inline Positioning: 
Allows absolute inline positioning on a FIELD command for specific placement of elements. 


Attributes are Special FIELDs: 
The attribute is identified by name and the data printed is from the attribute value or a portion of 
the attribute value and not from the element content. 


Notes: 


1. Ifa FIELD is used for presenting any piece of data on the XLAYOUT command, FIELD commands 
must be used for all pieces of data presented on the XLAYOUT command. Since an attribute is a 
special field, if you want to print both an attribute value and the element data you need to code the 
attribute field for the attribute value and a regular field for the element data. 

2. PSF suppresses leading and trailing blanks (X'40' for EBCDIC or X'20' for ASCII) in the data. Multiple 
embedded blanks are reduced to one blank. 
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XML Data Element Example 


An application can group XML data elements to be formatted together as an entity by grouping those 


elements hierarchically under a collection XML data element. The data order normally does not matter in 


formatting the data elements unless the elements are to be placed relative to each other in the inline 
direction. Any elements to be placed inline relative to each other must be ordered in inline 
order. Use the XLAYOUT/FIELD commands to place the data on the presentation device. 
example of a bank customer showing the “name” and “address” fields placed together: 


<Customer> 
<name> 
<title>Dr.</title> 
<first>Kelly</first> 
<last>Green</last> 
</name> 
<address> 
<strno>1911</strno> 
<street>Colt Lane</street> 
<city>Longmont</city> 
<state>C0Colorado</state> 
<zip>80501</zip> 
</address> 
</Customer> 


Figure 62. XML Data Elements 


The example in|Figure 62|results in the following printed output: 


Dr. Kelly Green 
1911 Colt Lane 
Longmont, CO 80501 


The page definition used to create the output is as follows: 


PAGEDEF xmp101 UDTYPE ebcdic REPLACE yes; 


/* Use QTAG definitions to define short alias names 

/* that make coding the XLAYOUTs easier. Do the 

/* messy work here, allowing us to code on the XLAYOUT: 
/* XLAYOUT zip ... 

/* instead of: 

/* XLAYOUT QTAG 'Customer','address','zip' ... 


Define cust QTAG 'Customer' 7 
Define title QTAG 'Customer','name' ,'title'; 
Define first QTAG 'Customer','name' ,'first'; 
Define last QTAG 'Customer','name' ,'last' ; 
Define strno QTAG 'Customer','address' ,'strno' ; 
Define street QTAG 'Customer','address' ,'street' ; 
Define state QTAG 'Customer','address' ,'state' ; 
Define zip QTAG 'Customer','address' ,'zip' ; 


/* Print first line "Dr. Kelly Green" 

/* NOTE:-The "collector" Customer starts a new page 
/* -RELATIVE 0 is not the same as SAME 

/* -RELATIVE 0.167 is equivalent to a 6 CPI space 
/* along with FIELD TEXT, giving us 2 ways to 

/* leave a space. 

/* -Watch out for the POSITION defaults on XLAYOUT 
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*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 


presentation 
Figure 62} is an 
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/* and FIELDs */ 


XLAYOUT cust NEWPAGE; 
XLAYOUT title POSITION ABSOLUTE 1 in ABSOLUTE 1 in; 
XLAYOUT first POSITION RELATIVE 0 in RELATIVE 0; 
FIELD TEXT''; 
FIELD START 1 LENGTH *; 
XLAYOUT last POSITION RELATIVE 0.167 in RELATIVE 0; 


Jee teetenssanecssseeses sees ssece= seer sacs ==> =soSeeesesee «/ 
/* Print second line "1911 Colt Lane" */ 
[xesecsere seek eas seseh sees e essere sen see se sso Seseesancs «/ 


XLAYOUT strno POSITION ABSOLUTE 1 in NEXT; 
XLAYOUT street POSITION RELATIVE 0 RELATIVE 0; 
FIELD TEXT''; 
FIELD START 1 LENGTH *; 


[ee sescessesas sea ssssesseeessseceseeeesSacesesesueepseee «/ 
/* Print third line "Longmont, CO 80501" x*/ 
[estan teereass sasenseeesne ss ose ces seers =ee aes eo- ee ee «/ 


XLAYOUT city POSITION ABSOLUTE 1 in NEXT; 
XLAYOUT state POSITION RELATIVE 0 RELATIVE 0; 

FIELD TEXT','; 

FIELD START 1 LENGTH 2; /*just the abbreviation/* 
XLAYOUT zip POSITION RELATIVE © RELATIVE 0; 

FIELD TEXT''; 

FIELD START 1 LENGTH *; 


In the above example, the XML data items “Dr.”, “Kelly”, and “Green” are printed relative to each other 

using relative inline positioning. This can only be done because the data appears in the following order: 
the title, “Dr.” is first; the first name, “Kelly” is next;, and the last name, “Green” is last. However, if you 

wanted to use this data, and change the order of the names to print the last name followed by the first 

name, you must position the names using absolute inline positioning, because the data cannot be 


reordered using relative inline positioning. 
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XML Data Format Example 


XML allows the same data to be used for multiple presentation media 


formatted for printing with PPFA’s XML support. 


<?xml version="1.0" ?> 


<?xml:stylesheet type="text/xs1" href=bbbank.xs1"?> 


glee 
<!-- Data for XML Example 
<te= 
<document> 
<bankstatement> 
<customer> 
<acctno>026-257311</acctno> 
<name>Justin Case</name> 
<street>123 Redlight Lane</street> 
<cityst>Twistnshout, MA 02345</cityst> 
</customer> 
<begindate>JAN 02, 2002</begindate> 
<enddate>FEB 01, 2002</enddate> 
<!l-- 
<!-- Page number generator 
<loe 
<pagenumber> 
4 ee 
<!-- New account type = Super Checking Account 
<le= 
<supercheckingactivity type="Superchk"> 
<balance> 
<begin>2591.24</begin> 
<credit>1946.93</credit> 
<debit>1956.43</debit> 
<svchg>0.00</svchg> 
<end>0.00</end> 
</balance> 
<lou 
<!-- Credit 
glee 
<credits> 
<transaction> 
<type>DEPOSIT</type> 
<date>01/05/2002</date> 
<amt> 26.90</amt> 
</transaction> 
<transaction> 
<type>AUTO DEPOSIT</type> 
<date>01/05/2002</date> 
<amt> 954.27</amt> 
</transaction> 
<transaction> 
<type>AUTO DEPOSIT</type> 
<date>01/30/2002</date> 
<amt> 954.27</amt> 
</transaction> 


Figure 63. XML Data File (Part 1 of 5) 


. In|Figure 63) XML data file is shown 
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<transaction> 
<type>INTEREST</type> 
<date>01/31/2002</date> 
<amt> 11.49</amt> 
</transaction> 
<total> 
</credits> 
<!-- 
<!-- Checks 
<les 
<checks> 
<transaction> 
<chkno>352</chkno> 
<date>01/04/2002</date> 
<amt> 321.50</amt> 
<transaction> 
<transaction> 
<chkno>353</chkno> 
<date>01/05/2002</date> 
<amt> 100.00</amt> 
<transaction> 
<transaction> 
<chkno>354</chkno> 
<date>01/10/2002</date> 
<amt> 122.30</amt> 
<transaction> 
<transaction> 
<chkno>355</chkno> 
<date>01/11/2002</date> 
<amt> 59.95</amt> 
<transaction> 
<transaction> 
<chkno>356</chkno> 
<date>01/15/2002</date> 
<amt> 852.33</amt> 
<transaction> 
<transaction> 
<chkno>357</chkno> 
<date>01/30/2002</date> 
<amt> 500.35</amt> 
<transaction> 
</checks> 
<leos 
<!-- Daily Balances 
<!-- 
<balances> 
<baldata> 
<date>01/04/2002</date> 
<bal>2269.74</bal> 
</baldata> 
<baldata> 
<date>01/05/2002</date> 
<bal>2196.64</bal> 
</baldata> 
<baldata> 
<date>01/10/2002</date> 
<bal>2074.34</bal> 
</baldata> 
<baldata> 
<date>01/11/2002</date> 
<bal>2014.39</bal> 
</baldata> 


Figure 63. XML Data File (Part 2 of 5) 
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<baldata> 
<date>01/15/2002</date> 
<bal> 852.33</bal> 
</baldata> 

<baldata> 
<date>01/30/2002</date> 
<bal> 500.35</bal> 
</baldata> 
<total>2581.74</total> 

</balances> 


<!-- --> 
<!-- Statement trailer generator --> 
<!l-- --> 


<stmttrailer/> 
</superbankingactivity> 
</bankstatement> 
<bankstatement> 
<customer> 
<acctno>887 -278342</acctno> 
<name>Anna Merkin</name> 
<street>123 Chantilly Lane</street> 
<cityst>Long Neck Goose, VA 21177</cityst> 
</customer> 
<begindate>JAN 02, 2002</begindate> 
<enddate>FEB 01, 2002</enddate> 


<!l-- --> 
<!-- Page number generator --> 
<!-- --> 
<pagenumber> 

<!-- --> 
<!-- New account type = Super Checking Account --> 
<!l-- --> 
<supercheckingactivity="suprchk"> 

<balance> 


<begin>3722.23</begin> 
<credit>2084.58</credit> 
<debit>1908.94</debit> 
<svchg>0.00</svchg> 
<end>3897 .87</end> 
</balance> 


<!l-- --> 
<!-- Credits --> 
<!-- --> 
<credits> 
<transaction> 
<type>DEPOSIT</type> 


<date>01/11/2002</date> 
<amt> 17.37</amt> 
</transaction> 
<transaction> 

<type>AUTO DEPOSIT</type> 
<date>01/15/2002</date> 
<amt>1029.81</amt> 
</transaction> 
<transaction> 

<type>AUTO DEPOSIT</type> 
<date>01/30/2002</date> 
<amt>1029.81</amt> 
</transaction> 


Figure 63. XML Data File (Part 3 of 5) 
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<transaction> 
<type>INTEREST</type> 
<date>01/31/2002</date> 
<amt> 7.59</amt> 
</transaction> 
<total>2084.58</total> 
</credits> 
<!-- 
<!-- Checks 
<les 
<checks> 
<transaction> 
<chkno>759</chkno> 
<date>01/03/2002</date> 
<amt> 144.00</amt> 
</transaction> 
<transaction> 
<chkno>760</chkno> 
<date>01/04/2002</date> 
<amt> 93.11</amt> 
</transaction> 
<transaction> 
<chkno>761</chkno> 
<date>01/09/2002</date> 
<amt> 322.72</amt> 
</transaction> 
<transaction> 
<chkno>762</chkno> 
<date>01/11/2002</date> 
<amt> 102.43</amt> 
</transaction> 
<transaction> 
<chkno>763</chkno> 
<date>01/17/2002</date> 
<amt> 794.46</amt> 
</transaction> 
<transaction> 
<chkno>764</chkno> 
<date>01/29/2002</date> 
<amt> 452.22</amt> 
</transaction> 
</checks> 
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<le= s=> 


<!-- Daily Balances --> 
<!-- --> 
<balances> 
<baldata> 


<date>01/04/2002</date> 
<bal>3722.23</bal> 
</baldata> 

<baldata> 
<date>01/05/2002</date> 
<bal>3629.12</bal> 
</baldata> 

<baldata> 
<date>01/10/2002</date> 
<bal>3306.40</bal> 
</baldata> 

<baldata> 
<date>01/11/2002</date> 
<bal>3221.34</bal> 
</baldata> 

<baldata> 
<date>01/15/2002</date> 
<bal>4251.15</bal> 
</baldata> 

<baldata> 
<date>01/30/2002</date> 
<bal>3897 .87</bal> 
</baldata> 
<total>3897.87</total> 

</balances> 


<!l-- --> 
<!-- Statement trailer generator --> 
<!-- --> 


<stmttrailer> 
</supercheckingactivity> 
</bankstatement> 
</document> 


Figure 63. XML Data File (Part 5 of 5) 


Figure 64 on page 100}shows the resulting printed output from the XML data in|Figure 63 on page 95 


Chapter 4. Using Page Definition Commands for Record Format Line Data and XML Data 


99 


Big Brother Bank 


“We watch over you” 


P.O. Box 1573 
Beantown, MA 


02116 


Justin Case 
123 Redlight Lane 


TwistNshout, 


Super Checking Account Activity 


Beginning Balance Credits 


2591. 24 
Credits 


Checks 


Daily 
Balances 


1946. 93 


Description 


DEPOSIT 

AUTO DEPOSIT 
AUTO DEPOSIT 
INTEREST 


Total Credits 


Check No. 


Total Checks 


Date 


01/04/02 
01/05/02 
01/10/02 
01/11/02 
01/15/02 
01/30/02 


Final Balance 


MA 02345 


Debits 
1956. 43 


Date 


01/05/02 
01/15/02 
01/30/02 
01/31/02 


Date 


01/04/02 
01/05/02 
01/10/02 
01/11/02 
01/15/02 
01/30/02 


Balance 


2269. 74 
2196. 64 
2074. 34 
2014. 39 
852. 33 
500. 35 


Account Number: 
Statement Begin Date: 
Statement End Date: 


Service Charge 
0. 00 


Amount 


26. 90 
954. 27 
954. 27 

11. 49 


Interest Rate as of 01/04 * * * 5.321% 


Figure 64. XML Data Printed Output (Part 1 of 2) 
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026-257311 
JAN 02, 2002 
FEB 01, 2002 


Ending Balance 
2081. 74 


Big Brother Bank 


“We watch over you” Account Number: 887-278342 
P.O. Box 1573 Statement Begin Date: JAN 02, 2002 
Beantown, MA 02116 Statement End Date: FEB 01, 2002 


Anna Merkin 
123 Chantilly Lane 
Long Neck Goose, VA 21177 


Super Checking Account Activity 


Beginning Balance Credits Debits Service Charge Ending Balance 
3722. 23 2084. 58 1908. 94 0. 00 3897. 87 


Credits Description Date Amount 


DEPOSIT 01/11/02 17.37 
AUTO DEPOSIT 01/15/02 1029. 81 
AUTO DEPOSIT 01/30/02 1029. 81 
INTEREST 01/31/02 7.59 


Total Credits 


Checks Check No. Date Amount 


01/03/02 144. 00 
01/04/02 93.11 
01/09/02 322. 72 
01/11/02 102. 43 
01/17/02 794. 46 
01/29/02 452. 22 


Total Checks 


Daily Date Balance 


Balances SS a ee 
01/04/02 3722. 23 
01/05/02 3629. 12 
01/10/02 3306. 40 
01/11/02 3221. 34 
01/15/02 4251.15 
01/30/02 3897. 87 


Final Balance 


Interest Rate as of 01/04 * * * 5.321% 


Figure 64. XML Data Printed Output (Part 2 of 2) 


The page definition used to create the output in|Figure 64 on page 100}is shown in|Figure 65 on page 102 
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PAGEDEF bbbank replace yes 
WIDTH 8.5 in 
HEIGHT 11.0 in 
UDTYPE EBCDIC; 
FONT comp aQ@75nc TYPE EBCDIC;/*Big Brother Bank font ~*/ 


FONT ital al75dc TYPE EBCDIC;/*Italic theme */ 
FONT addr aQ75dc TYPE EBCDIC;/*Big Brother address */ 
FONT varb gtl0 TYPE EBCDIC;/*Variable data */ 
FONT super a075dc TYPE EBCDIC;/*Super Checking Account «/ 
FONT head aQ55ac TYPE EBCDIC;/*Headings */ 
FONT bhead aQ75ac TYPE EBCDIC;/*Bold Headings */ 

[KEK ARK EK KEIR KER AKER AKER KEK KKK KEKE KARE AKER AK | 

/** QTAG declarations x*/ 

[RRR KKK KK ERK KER AKER A KKK KKK AK KEK KEKE AK KEK KER AK | 

/*---- statmid declarations -------------------- */ 


DEFINE statmid QTAG C'document', 
C'bankstatement',C'customer'; 

DEFINE acctno QTAG C'document', 
C'bankstatement',C'customer',C'acctno'; 

DEFINE name QTAG C'document', 
C'bankstatement',C'customer',C'name'; 

DEFINE street QTAG C'document', 
C'bankstatement',C'customer',C'street'; 

DEFINE cityst QTAG C'document', 
C'bankstatement',C'customer',C'cityst'; 

DEFINE begindate QTAG C'document', 
C'bankstatement',C'begindate'; 

DEFINE enddate QTAG C'document', 
C'bankstatement',C'enddate'; 

/*---- statsum declarations -------------------- */ 

DEFINE statsum QTAG C'document', 
C'bankstatement',C'supercheckingactivity' 
C'balance' ; 

DEFINE statsumfl QTAG C'document', 
C'bankstatement',C'supercheckingactivity' 
C'balance', c'begin'; 

DEFINE statsumf2 QTAG C'document', 
C'bankstatement',C'supercheckingactivity' 


C'balance', c'credit'; 

DEFINE statsumf3 QTAG C'document', 
C'bankstatement',C'supercheckingactivity' 
C'balance', c'debit'; 

DEFINE statsumf4 QTAG C'document', 
C'bankstatement',C'supercheckingactivity' 
C'balance', c'svchg'; 

DEFINE statsumf5 QTAG C'document', 


C'bankstatement' ,C'supercheckingactivity' 
C'balance', c'end'; 
/*---- crdata declarations -------------------- */ 

DEFINE crheader QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'credits'; 

DEFINE crdatal QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'credits',C'transaction',C'type' ; 

DEFINE crdata2 QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'credits',C'transaction',C'date' ; 
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DEFINE crdata3 QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'credits',C'transaction',C'amt' ; 

DEFINE crtotal QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'credits',C'total'; 

/*---- ckdata declarations -------------------- */ 

DEFINE ckheader QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'checks' ; 

DEFINE ckdatal QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'checks',C'transaction',C'chkno' ; 

DEFINE ckdata2 QTAG C'document', 
C'bankstatement' ,C'supercheckingactivity', 
C'checks',C'transaction',C'date' ; 

DEFINE ckdata3 QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'checks',C'transaction',C'amt' ; 

DEFINE cktotal QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'checks', C'total'; 

/*---- baldata declarations -------------------- */ 

DEFINE balhead QTAG C'document', 

C'bankstatement',C'supercheckingactivity', 

C'balances'; 

DEFINE baldatal QTAG C'document', 

C'bankstatement',C'supercheckingactivity', 

C'balances',C'baldata',C'date' ; 

DEFINE baldata2 QTAG C'document', 

C'bankstatement',C'supercheckingactivity', 

C'balances',C'baldata',C'bal' 3; 

DEFINE baltotal QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'balances', C'total'; 

/*---- misc. declarations -------------------- */ 

DEFINE statrail QTAG C'document', 
C'bankstatement',C'supercheckingactivity', 
C'stmttrailer'; 

DEFINE pgenum QTAG C'document', 
C'bankstatement',C'pagenumber' ; 


[Resse sassessesseseceesteoossssecessosssscesesas */ 
/*---- end of QTAG declarations ---------------- */ 
jRasceieadosaeses seenesesccssscssesassessssssssc */ 


PAGEFORMAT xchubl TOPMARGIN 2 in BOTMARGIN 1 in; 
[BERR KKK KK EAR KEK KER AKER K EEK KKK EKER EKER ARERR | 
/** statmid HEADER xx / 
[ REKRK RRR KEKE IKK A KKK KKK KK KKK KEK KEKE KK KEK KER KK | 
XLAYOUT statmid PAGEHEADER NEWPAGE 
POSITION .6 in ABSOLUTE .55 in; 
FIELD TEXT C'Big Brother Bank' ALIGN LEFT 
FONT comp ; /* default to LAYOUT positioning */ 
FIELD TEXT C'"We watch over you"' ALIGN LEFT 
POSITION 0 NEXT 
FONT ital ; /*default to next line */ 
FIELD TEXT C'P.O. Box 1573' ALIGN LEFT 
POSITION 0 NEXT 
FONT addr ; /*default to next line */ 


Figure 65. Page Definition for XML Output (Part 2 of 7) 
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FIELD TEXT C'Beantown, 


MA 02116' ALIGN LEFT 


POSITION 0 NEXT 


FO 


T addr ; /*default to next line 


FIELD TEXT C'Account Number:' ALIGN LEFT 
POSITION 4.3 in .2 in 
FONT head ; /*New area on right 
FIELD TEXT C'Statement Begin Date:' ALIGN LEFT 
POSITION 4.3 in NEXT 
FONT head ; /*New area on right 
FIELD TEXT C'Statement End Date:' ALIGN LEFT 
POSITION 4.3 in NEXT 


FO 


T head ; /*New area on right 


XLAYOUT acctno PAGEHEADER CONTINUE 


POSITION SAME SAME; 


FIELD START 1 LENGTH 10 ALIGN RIGHT 
POSITION 7.5 in .2 in 
FONT varb ; 


XLAYOUT begindate PAGEHEADER CONTINUE 


POSITION SAME SAME; 


FIELD START 1 LENGTH 12 
POSITION 7.5 in .37 in 
ALIGN RIGHT 
FONT varb ; 
XLAYOUT enddate PAGEHEADER CONTINUE 


POSITION SAME SAME; 


FIELD START 1 LENGTH 12 
POSITION 7.5 in .53 in 
ALIGN RIGHT 


FONT varb ; 
XLAYOUT name PAGEHEADER CONTINUE 
POSITION SAME SAME; 
FIELD START 1 LENGTH 19 ALIGN LEFT 
POSITION 1.1 in .9 in 
FONT varb ; 


XLAYOUT street PAGEHEADER CONTINUE 


POSITION SAME SAME; 


FIELD START 1 LENGTH 19 ALIGN LEFT 
POSITION 1.1 in 1.07 in 
FONT varb ; 


XLAYOUT cityst PAGEHEADER CONTINUE 


POSITION SAME SAME; 


FIELD START 1 LENGTH 22 ALIGN LEFT 
POSITION 1.1 in 1.23 in 
FONT varb ; 


[BRK RK KEKE K RAK KER AKER AKER KEIR KEK KK EA AKER AKER AK | 


/** statsum BODY 


*x*/ 


[RRR KKK KK EAR KKK AKER KKK KKK AK KEK KK EAA KEK AKER KK | 
XLAYOUT statsum BODY 
POSITION .6 in .5 in; 
FIELD TEXT C'Super Checking Account Activity' 
FONT super ; /* Static text - Super Checking */ 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 


POSITION 0 
copy down 2 


15 in 
spaced 1 mm; 


FIELD TEXT C'Beginning Balance’ 
POSITION .3 in .4 in 


FONT head 


FIELD TEXT C'Credits' 
POSITION 2.4 in CURRENT 


FONT head 
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; /* Static text - first header 


; /* Static text - first header 


*/ 


*/ 


*/ 


FIELD TEXT C'Debits' 
POSITION 3.6 in CURRENT 
FONT head ; /* Static text - first header */ 
FIELD TEXT C'Service Charge' 
POSITION 4.8 in CURRENT 
FONT head ; /* Static text - first header */ 
FIELD TEXT C'Ending Balance' 
POSITION 6.3 in CURRENT 
FONT head ; /* Static text - first header */ 
XLAYOUT statsumfl BODY 
POSITION SAME .6 in; 
FIELD START 1 LENGTH 8 
POSITION .6 in CURRENT 
FONT varb ; /* Variable text - Beg balance */ 
XLAYOUT statsumf2 BODY 
POSITION SAME SAME; 
FIELD START 1 LENGTH 8 
POSITION 2.2 in CURRENT 
FONT varb ; /* Variable text 
XLAYOUT statsumf3 BODY 
POSITION SAME SAME; 
FIELD START 1 LENGTH 8 
POSITION 3.4 in CURRENT 
FONT varb ; /* Variable text - Debits */ 
XLAYOUT statsumf4 BODY 
POSITION SAME SAME; 
FIELD START 1 LENGTH 5 
POSITION 5.0 in CURRENT 
FONT varb ; /* Variable text - Service Chrg */ 
XLAYOUT statsumf5 BODY 
POSITION SAME SAME; 
FIELD START 1 LENGTH 8 
POSITION 6.5 in CURRENT 
FONT varb ; /* Variable text 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION © .1 in; 
[BRK RK KEK KEKE IKKE KK KER AKER AKER KKK EKER EKER ARERR | 
/** crheader GROUPHEADER xx / 
[KEK KK ERK KK ER KKK AK KKK KEK KKK KK KEK KEKE KKK K KEKE | 
XLAYOUT crheader GRPHEADER XSPACE .2 in 
POSITION SAME .3 in; 
FIELD TEXT C'Credits' 
FONT bhead ; /* Static text - Credits */ 
FIELD TEXT C'Description' 
POSITION 1.3 in CURRENT 
FONT head 3; /* Stat text - Deposit Descr. */ 
FIELD TEXT C'Date' 
POSITION 3.2 in CURRENT 
FONT head ; /* Static text - Date */ 
FIELD TEXT C'Amount' 
POSITION 5.0 in CURRENT 
FONT head ; /* Stat text - Amount of deposit*/ 
DRAWGRAPHIC LINE ACROSS 6.2 IN LINEWT BOLD 
POSITION 1.3 in next; 
[BERR KKK KK EAR KEK KERIKERI KEK KEKE AK KER ARERR | 
/** crdata BODY xx / 
[BRK KKK KKK RAK K RAKE KKK IKK KIRK KEK KEKE AK KER AKER KK | 
XLAYOUT crdatal BODY GROUP; 
FIELD START 1 LENGTH 13 
POSITION 1.3 in CURRENT 
FONT varb ; /* Variable text - Description */ 


Credits */ 


End Balance */ 


Figure 65. Page Definition for XML Output (Part 4 of 7) 
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XLAYOUT crdata2 BODY GROUP position same same; 
FIELD START 1 LENGTH 8 
POSITION 3 in CURRENT 
FONT varb ; /* Variable text - Date 
XLAYOUT crdata3 BODY GROUP position same same; 
FIELD START 1 LENGTH 8 ALIGN RIGHT 
POSITION 5.6 in CURRENT 
FONT varb ; /* Variable text - Amount 
[RRR KKK KK ERK KKK AKER KK KKK KAR KEK KK EA AKER AKER AK | 
/** crtotal BODY x*/ 
[RRR KKK KKK RAK KKK AKER KK KKK KKK KEK KK EAA KEK AKER AK | 
XLAYOUT crtotal BODY GROUP; 
FIELD TEXT C'Total Credits' 
POSITION 1.5 in .2 in 
FONT bhead ; /* Stat text - Total credits 
FIELD START 1 LENGTH 8 ALIGN RIGHT 
POSITION 7.3 in CURRENT 
FONT varb ; /* Variable text - Amount 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION 0 next; 
[RRR RK KERR KERR KER AKER AKER KEK AK KEK KEKE AK KER EKER EK | 
/** ckheader GROUPHEADER «x / 
[RRR KKK KKK EAA KEK KKK KK KKK KKK KKK KEKE AK KKK K KER AK | 
XLAYOUT ckheader GRPHEADER XSPACE .2 IN 
POSITION SAME .6 in; 
FIELD TEXT C'Checks' 
FONT bhead ; /* Static text - Checks 
FIELD TEXT C'Check No.' 
POSITION 1.3 in CURRENT 
FONT head 3; /* Stat text - Check number 
FIELD TEXT C'Date' 
POSITION 3.2 in CURRENT 
FONT head ; /* Stat text - Date of check 
FIELD TEXT C'Amount' 
POSITION 5.0 in CURRENT 


*/ 


*/ 


FONT head 3; /* Static text - Amount of check*/ 


DRAWGRAPHIC LINE ACROSS 6.2 IN LINEWT BOLD 
POSITION 1.3 in next; 
[RRR KKK KKK ERK KKK AKER AKER KKK KKK KK EA KKK AKER KK | 
/** ckdata BODY x*/ 
[BRK R KKK KK EAK KER AKER AKER KKK KA KKK KEKE KKK ER AKER AK | 
XLAYOUT  ckdatal BODY GROUP 
POSITION SAME NEXT; 
FIELD START 1 LENGTH 3 
POSITION 1.5 in CURRENT 


FONT varb ; /* Variable text - Check number 


XLAYOUT ckdata2 BODY GROUP position same same; 
FIELD START 1 LENGTH 8 
POSITION 3.0 in CURRENT 
FONT varb ; /* Variable text - Date 
XLAYOUT ckdata3 BODY GROUP position same same; 
FIELD START 1 LENGTH 8 ALIGN RIGHT 
POSITION 5.6 in CURRENT 
FONT varb ; /* Variable text - Amount 
[ REKRKKRAKK RAK KER AKER AKER KKK AK KEK KEKE AK KER AKER AK | 
/** cktotal BODY xx / 
[RRR KKK KKK ERK KER AKER A KKK KKK AK KEK KK EA AKER A KER AK | 
XLAYOUT cktotal BODY GROUP; 
FIELD TEXT C'Total Checks' 
POSITION 1.5 in .2 in 
FONT bhead ; /* Stat text - Total checks 
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FIELD START 1 LENGTH 8 ALIGN RIGHT 
POSITION 7.3 in CURRENT 
FONT varb ; /* Variable text - Amount */ 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION QQ next; 
[ REK RK KKK KEK KKK KKK AKER KK KIRK KEK KKK KKK K KEKE | 
/** balhead GROUPHEADER x/ 
[KEK RK RRA KK EAR REAR KEK AKER KKK A KK EK KEKE KKK ER ARERR | 
XLAYOUT balhead GRPHEADER XSPACE .2 in 
POSITION SAME .6 in; 
FIELD TEXT C'Daily' 
FONT bhead ; /* Static text - Daily Balance +*/ 
FIELD TEXT C'Date' 
POSITION 1.3 in CURRENT 
FONT head ; /* Stat text - Date of balance */ 
FIELD TEXT C'Balance' 
POSITION 3.15 in CURRENT 
FONT head ; /* Static text - Balance */ 
FIELD TEXT C'Balances' 
POSITION © NEXT 
FONT bhead ; /* Static text - Daily Balance +*/ 
DRAWGRAPHIC LINE ACROSS 6.2 IN LINEWT BOLD 
POSITION 1.3 in CPOS; 
[KEK RK KEK KK ERK KAKA KKK KKK KKK KEKE KK KEK AKER KK | 
/** baldata BODY x«/ 
[RE KR KKK K KEIR KEK KER AKER KKK KEKE KEK EKER EKER ARERR | 
XLAYOUT baldatal BODY GROUP 
POSITION SAME NEXT; 
FIELD START 01 LENGTH 8 
POSITION 1.3 in CURRENT 
FONT varb ; /* Variable text - Date */ 
XLAYOUT baldata2 BODY GROUP position same same; 
FIELD START 01 LENGTH 8 ALIGN RIGHT 
POSITION 3.8 in CURRENT 
FONT varb ; /* Variable text - Amount */ 
[BRK RK RRA KK EAR KER KKK A KEK KEK KKK KEKE KEKE AKER | 
/** baltotal BODY x«/ 
[KEK RK KERR EKER KERR KKK KKK KKK KKK KARR EAA KEKE KK | 
XLAYOUT baltotal BODY GROUP; 
FIELD TEXT C'Final Balance' 
POSITION 1.5 in <2. in 
FONT bhead ; /* Stat text - Final balance */ 
FIELD START 1 LENGTH 8 ALIGN RIGHT 
POSITION 7.3 IN CURRENT 
FONT varb ; /* Variable text - Amount */ 
[KEK RK RRA KK EIR KEK KK ERA K ERK KERR EK KEKE KEKE ARERR | 
/** statrail BODY x*/ 
[ REK RK RRR KK EK KKK KKK KKK KKK K KKK KEK KK EAA KKK KEKE | 
XLAYOUT statrail BODY 
POSITION SAME .4 in; 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION 0 CPOS; 
FIELD TEXT C'Interest Rate ' 
POSITION 2.0 in NEXT 
FONT bhead ; /* Static text - Interest rate */ 
FIELD TEXT C'As of 01/04 * * * 5.321%! 
POSITION CURRENT CURRENT 
FONT varb ; | /* Static text x*/ 
DRAWGRAPHIC LINE ACROSS 7.5 IN LINEWT BOLD 
POSITION 0 NEXT 
copy down 2 spaced 1 mm; 
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[KEK RK KKK KK RAK KKK AKER A KKK KKK AK KEK KK EAA KER AKER KK | 
/** pgenum PAGE NUMBER ae / 
[KERR KKK KEKE AK KER AKER A KERR KEI KKK KK EA AKER AKER AK | 
XLAYOUT pgenum PAGETRAILER 
POSITION SAME ABSOLUTE 10.7 in; 
FIELD TEXT C 'Page ' 
POSITION 6.5 in CURRENT 


FONT varb; /* placement of page number 
FIELD PAGENUM PRINT /* request page numbering 
FONT varb /* placement of page number 


POSITION CURRENT CURRENT; 
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*/ 
*/ 
*/ 


Chapter 5. Creating Complex Printouts 


You are now ready to learn about some formatting tasks that might apply to more complex printouts. The 
basic form definition and page definition elements have been covered. This chapter describes how these 
elements are combined to create complete print jobs. 

The advanced techniques covered in this section are illustrated in the following examples: 


Table 5. Form Definitions and Page Definition Tasks 


Tasks Example location 

Field Processing with Overlay “Combining Field Processing and an Electronic Overlay” 
on page 109 

Suppressing Data “Using Suppressions to Vary Data Presentation” on 
page 111 

Including Fixed Text “Incorporating Fixed Text into a Page Definition” on 
page 112 

Combining Two Reports “Combining Two Reports into One Printout” on page 115 


The examples in this chapter build on a single sales application, showing different sales reports being 
formatted by form definitions and page definitions. 


Combining Field Processing and an Electronic Overlay 


This example involves printing a monthly individual sales report for a specified distribution. The following 
items are needed to generate the sales report: 

* A pre-designed electronic overlay for the sales report 

¢ An unformatted print data file with periodic sales statistics 


An example of these is shown in|Figure 66 on page 110 
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j~—<t am 
Plt tt |b ta 
A 
_ | SALESMAN 
TERRITORY | NO. 
MONTH 
MODEL UNITS | $(000) %of TOTAL 
4in. — 
Y 
Overlay 
123456789 123456789 123 
R1 Jjo}hAln} [Sim] i ft} 
R2 Tie|xjals 0|7|7}1|4 
R3 Nioly 
R4 Slile|riria 1/2 5|9 6 
R6 O|tlelr 1/6 7\0 1\0 
R6 Algjuja 6} 0 1/;0]4 1]5 
R7 A\l}ljelg|rje 7/1 21615 4\0 
Data File 


Figure 66. Electronic Overlay and Data File for a Sales Report 


The code example that follows contains a form definition and a page definition 


the file to the overlay. 


. The page definition maps 


In [Figure 66]the 0,0 point is the upper-left corner of the overlay. This means that the logical page origin 
must coincide with the overlay origin in this example. POSITION subcommands are relative to the logical 
page origin. The overlay origin point that positions the overlay is specified in the Overlay Generation 
Language/370 that creates the overlay, but can be modified in the page definition. In mapping to an 
overlay, you should check the input to the overlay creation program so you can coordinate its origin with 
the logical page origin. You can reposition the overlay through the PRINTLINE command. 


01 FORMDEF SLSRPT OFFSET 0 0 ; 
02 OVERLAY SLSRPT ; 
03 SUBGROUP OVERLAY SLSRPT ; 


05 PAGEDEF SLSRPT ; 


@6 PRINTLINE POSITION 2 IN 1.3 IN 3; /* RECORD 1 


07 FIELD START 1 LENGTH 23 


08  PRINTLINE POSITION 2 IN 1.70 IN ; /* RECORD 2 


09 FIELD START 1 LENGTH 9 ; /* 
10 FIELD START 10 LENGTH 5 

11 POSITION 4.3 IN * 3 /* 
12 /* 


13. PRINTLINE POSITION 1.5 IN6 IN; /* 
14 FIELD START 1 LENGTH 4 ; 
15 SETUNITS LINESP 4 LPI ; 


16 PRINTLINE REPEAT 4 /* 
17 POSITION 1.5 IN 3.6 IN ; 
18 FIELD START 1 LENGTH 7 ; /* 
19 FIELD START 10 LENGTH 3 

20 POSITION 1.5 IN * ; 
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DEFAULT POSITION 
THE ASTERISK MEANS 
CURRENT LINE 
RECORD 3 

RECORDS 4-7 


DEFAULT POSITION 


*/ 


*/ 
*/ 


*/ 
*/ 
*/ 
*/ 
*/ 


21 FIELD START 16 LENGTH 3 


22 POSITION 2.5 IN * ; 
23. FIELD START 21 LENGTH 3 
24 POSITION 3.5 IN * ; 


A time-saving device used in the above example is the REPEAT subcommand (line 16), which maps a 
single printline with its field subsets to records 4 through 7 with all model names and sales statistics. The 
length values in the repeated fields are 7, 3, 3, and 3—sufficient to accommodate the largest model name, 
unit value, $(000), and percentage fields mapped by this FIELD command. 


Figure 67|shows the report formatted by the resources generated in the command stream of this example. 


I< 6IN: > 
eed ee eee ee | i a 
4 [SALESMAN John Smith 
-|TERRITORY Texas [| _NO.07714 
MONTH Nov. 
~/MODEL | UNITS | $ (000) % of TOTAL 
-| Sierra 12 59 6 
4IN. —| Otero 16 70 10 
“| Agua 60 104 15 
| Allegre 71 265 40 
y 


Figure 67. Sales Report 


Using Suppressions to Vary Data Presentation 


PPFA and your print server printers enable you to produce variations of the same report in a single job. 
The essential function for this capability is called suppression. Suppression involves the coordinated 
specification of elements in both the page definition and the form definition. You create a suppression in 
the page definition and turn it on or off in a subgroup within a form definition. 


This example shows how to alter the controls in the previous example 
in order to generate a second report along with the one already 
created. 

First, change the page definition by adding a SUPPRESSION subcommand to the third field in the 
repeated printline—the printline that mapped the models and sales figures in 
find ah Eloctionis Overy" onpage 4091 The suppression is, in effect, created by the SUPPRESSION 
subcommand in the FIELD command. The following example shows the addition at line 23. 


18 FIELD START 1 LENGTH 7 ; 
19 FIELD START 10 LENGTH 3 


20 POSITION 1.5 IN * ; 

21 FIELD START 16 LENGTH 3 

22 POSITION 2.5 IN * 

23 SUPPRESSION SALES ; /*ADDED LINE */ 
24 FIELD START 21 LENGTH 3 

25 POSITION 3.5 IN * ; 


The SUPPRESSION subcommand creates the potential for selective suppression of the data in the 
“$(000)” field of the report. 


Then, rewrite the form definition, creating two subgroups within the copy group. Next, write a 
SUPPRESSION command immediately after the FORMDEF command. Finally, place a SUPPRESSION 
subcommand in the subgroup in which you want the data suppressed. This names the suppression. The 
resulting form definition command stream is as follows: 
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FORMDEF SECRPT ; 


SUPPRESSION SALES ; /*NAMING THE SUPPRESSION */ 
COPYGROUP SECRPT ; 
OVERLAY SLSRPT ; /*NAMING THE OVERLAY */ 


SUBGROUP COPIES 1 
OVERLAY SLSRPT ; 
SUBGROUP COPIES 1 
OVERLAY SLSRPT 
SUPPRESSION SALES ;  /*TURNING ON THE SUPPRESSION */ 


The result is shown in|Figure 68} The second subgroup creates the second output page of the same data 
with a second set of modifications; in this case, modifications means a suppression that is not in the first 
subgroup. 


SALESMAN — John Smith SALESMAN John Smith 
TERRITORY Texas |NO. 07714 TERRITORY Texas |NO. 07714 
MONTH _ Nov. MONTH Nov. 
MODEL UNITS | $(000) |%ofTOTAL MODEL UNITS | $(000) |%of TOTAL 
Sierra 12 59 6 Sierra 12 a 6 
Otero 16 70 10 Otero 16 | | 10 
Agua 60 104 15 Agua 60 | 15 
Allegre 71 265 40 Allegre 71 i a 40 

\ Suppressed Fields 


Subgroup 1 Subgroup 2 


Figure 68. Selective Suppression 


Review the steps in this example. To suppress a field, identify the field as suppressible in the page 
definition under the FIELD command in question. Then create a subgroup, activating this suppression with 
a SUPPRESSION subcommand in the form definition. 


The first subgroup produces an output identical to the report in|“Combining Field Processing and an 
Electronic Overlay” on page 109 


It contains no suppression. 


Note: This example can only be printed simplex. 


Incorporating Fixed Text into a Page Definition 


Fixed text can be incorporated into an electronic overlay through the use of programs, such as Overlay 
Generation Language/370. Having another place (the page definition) to incorporate fixed text permits you 
to format documents more efficiently. 


In |‘Combining Field Processing and an Electronic Overlay” on page 109} a territory sales report for 


salesman John Smith is created. Here, the territory sales report is incorporated into a larger format going 
to ACME’s corporate headquarters in Chicago. Therefore, the identification for the region needs to appear 


on the report form. An overlay is used as a header for the composite report. This means that two overlays 
appear in the command stream: one carries over from|“Combining Field Processing and an Electronic 
Overlay” on page 109) and the other is the header. 


So, as shown in|Figure 69 on page 113} three fixed inputs generate the final report: overlay SLSRPT, 


overlay HDR, and the fixed regional identification text. (It is the second item that is worked into the page 
definition in this example.) 
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SALESMAN 
TERRITORY | NO. 


MONTH 
MODEL UNITS | $(000) %of TOTAL 


| 
Overlay SLSRPT 


INDIVIDUAL SALES REPORT 
ACME CORP. - CHICAGO 


Regional Mgrs. Submit 
First Monday in Each Month 


Overlay HDR 


Southwest Region 
Jim Jones - Manager 


Fixed Text 


Figure 69. Input for the Corporate Version of an Individual Sales Report 


The data file used to generate this report is the same as the one shown in|Figure 66 on page 110 


FORMDEF CORP ; 

OVERLAY SLSRPT ; 

OVERLAY HDR ; 

SUBGROUP OVERLAY SLSRPT HDR ; 
PAGEDEF CORP 


WIDTH 6 IN 
HEIGHT 7 IN ; 
PRINTLINE POSITION 1.9 IN 2.5 IN ; /*RECORD 1 */ 
FIELD TEXT C ‘SOUTHWEST REGION' ; /*DEFAULT FIELD TEXT */ 
/*POSITION */ 
FIELD POSITION -.2 IN NEXT /*NOTE NEGATIVE VALUE */ 
TEXT 1 C 'JIM JONES - MANAGER' ; 
FIELD START 1 LENGTH 23 
POSITION .1 IN .8 IN ; 
PRINTLINE POSITION 2 IN 3.7 IN ; /*RECORD 2 */ 
FIELD START 1 LENGTH 9 ; /*DEFAULT FIELD */ 
/*POSITION */ 


FIELD START 10 LENGTH 5 
POSITION 2.5 IN * 3; 
PRINTLINE POSITION 1.5 IN 4 IN 3 /*RECORD 3 */ 
FIELD START 1 LENGTH 4 ; 
SETUNITS LINESP 4 LPI ; 


PRINTLINE REPEAT 4 /*RECORDS 4-7 */ 
POSITION .4 IN 4.7 IN ; 

FIELD START 1 LENGTH 7 ; /*DEFAULT FIELD */ 

/*POSITION */ 


FIELD START 10 LENGTH 3 
POSITION 1.6 IN * ; 
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FIELD START 16 LENGTH 3 
POSITION 2.9 IN * ; 

FIELD START 21 LENGTH 3 
POSITION 4.3 IN * ; 


In the above command stream, the same basic commands from |“Combining Field Processing and an 


Electronic Overlay” on page 109} are used, although the positions of fields have been changed to 
accommodate the new layout. 


New FIELD commands with TEXT subcommands have been inserted in the first PRINTLINE command to 
produce the regional text, which is positioned at the bottom of the header form. The 1 is a duplication 
parameter indicating how many times the fixed text is to be repeated. The C can precede single-byte 
characters such as those used, for example, to write English or German. Both 1 and C are the default 
values for a TEXT subcommand. The text you want inserted appears between single quotation marks. 
Observe how the POSITION subcommands change to accommodate both fixed text and record-1 text. 


Note: Each PRINTLINE command in your PPFA command stream should have a corresponding record in 
the input data file. If you specify a fixed-text data field and an input data field under the same 
PRINTLINE command, they are both associated with the same input data file record. However, if all 
the FIELD commands under a PRINTLINE command specify fixed text, the corresponding input 
record is discarded. In that case, you should insert a blank record into the input data file to 
preserve the correct relationship between records and PRINTLINE commands. 


Figure 70|shows how the finished output looks. 


Origin of Overlay 
a Logical Page 
e 


A 
ae INDIVIDUAL SALES REPORT 
ACME CORP. - CHICAGO 
— Regional Mgrs. Submit ; 
First Monday in Each Month Fixed Text 
South tees for Regional 
eon incr daca Identification 
‘ Jim Jones - Manager 
7in. I 
__| SALESMAN — John Smith 
TERRITORY Texas NO. 07714 
MONTH _ Nov. 
~ | MODEL UNITS | $(000) % of TOTAL 
4 in. — Sierra 12 59 6 
Otero 16 70 10 
= Agua 60 104 15 
= Allegre 71 265 40 
‘oe | 
I | j | fo byt yt 
<t 6in. >| 


Output 


Figure 70. The Corporate Version of the Sales Report with Fixed Text 
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Combining Two Reports into One Printout 


This example combines two data files and two page layouts into one printout, also building on 
Field Processing and an Electronic Overlay” on page 109) 
Figure 71|shows the new data and a new overlay. 


R1 
R2 
R3 
R4 
R5 
R6 
R7 


R8 
RQ 
R10 
R11 
R12 
R13 


Figure 71. Input for a New Report Produced from the Combined Data Files 


—|Salesman’s Commission Report 


Acme Corp. 


TO: 

As your sales for 199 

were $ , and 

your commission rate is %, 

your monthly commission is 
. Should there 

be any question, please 

contact in 

accounting. 


Sincerely, 
Acme Corp. 


34 


Overlay COMRPT 


656789 123456789 
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Data File 


Here is the command stream needed to generate both pages of the preceding report: 


FORMDEF SLSCOM ; 
COPYGROUP SLSRPT ; 
OVERLAY SLSRPT ; 
SUBGROUP OVERLAY SLSRPT ; 
COPYGROUP COMRPT ; 
OVERLAY COMRPT ; 
SUBGROUP OVERLAY COMRPT ; 
PAGEDEF SLSCOM ; 
FONT M104 ; 
FONT M105 ; 
PAGEFORMAT SLSRPT ; 
PRINTLINE FONT M104 


POSITION 2 IN .5 IN ; 


FIELD START 1 LENGTH 23 ; 


PRINTLINE POSITION 2 IN .75 IN 3 


FIELD START 1 LENGTH 9 ; 
FIELD START 10 LENGTH 5 
POSITION 2.3 IN * ; 


/*SALES REPORT*/ 


/*DEFAULT FIELD POSITION*/ 
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PRINTLINE POSITION 1.5 IN 1 IN ; 
FIELD START 1 LENGTH 4 ; 
PRINTLINE REPEAT 4 
POSITION .3 IN 1.8 IN ; 
FIELD START 1 LENGTH 7 ; /*DEFAULT FIELD POSITION 
FIELD START 11 LENGTH 3 
POSITION 1.5 IN * 3 
FIELD START 16 LENGTH 3 
POSITION 3 IN * 
FIELD START 21 LENGTH 
POSITION 4.3 IN * ; 
PAGEFORMAT COMRPT ; /*COMMISSION REPORT x/ 
PRINTLINE FONT M105 /*RECORD 8 x/ 
POSITION 1.3 IN 1.7 IN ; 
FIELD START 1 LENGTH 18 ; 
PRINTLINE POSITION 3.3 IN 2.2 IN ;  /*RECORD 9 */ 
FIELD START 1 LENGTH 4 ; /*DEFAULT FIELD POSITION x/ 
FIELD START 10 LENGTH 1 
POSITION 1.7 IN * ; 
PRINTLINE POSITION 1.9 IN 2.6 IN ; /*RECORD 10 x/ 
FIELD START 1 LENGTH 10 ; 
PRINTLINE POSITION 4.2 IN 2.9 IN ; /*RECORD 11 x/ 
FIELD START 1 LENGTH 1 ; 
PRINTLINE POSITION 1 IN 3.7 IN 3 /*RECORD 12 x/ 
FIELD START 1 LENGTH 7 ; 
PRINTLINE POSITION 1.7 IN 4.2 IN ; /*RECORD 13 */ 
FIELD START 1 LENGTH 15 ; 


+ 


/ 


Wee 


+ 


Although requiring a complex series of commands, the following commission report is handled much like 
any other field processing problem: the data must be carefully mapped into the overlay exactly where it is 
wanted. If, as in this example, you change copy groups and page formats, both the Invoke Medium Map 
structured field and the Invoke Data Map structured field must be inserted into the data file where the 
changes are desired. Here they occur together. 


Figure 72|shows both the commission report and the sales report. With page printers and with careful data 
positioning, such reports look like they were individually prepared with no differences in the presentation of 
the fixed data. 


Salesman’s Commission Report 
SALESMAN  JohnSmith Acme Corp. 
TERRITORY Texas NO. 07714 To: John Smith 
MONTH Nov. 
0, As your sales for Nov. 1995 

MODEL UNITS | $(000) [%of TOTAL were $498,000.00, and 
Sierra 12 59 6 your commission rate is 2 %, 
Otero 16 70 10 your monthly commission is 
Agua 60 104 15 $9960.00. Should there 
Allegre 71 265 40 be any question, please 

contact Al Jankowski in 

accounting 

Sincerely, 

Acme Corp. 


Figure 72. The Sales and the Commission Reports 
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Chapter 6. Conditional Processing 


Conditional processing allows you to test fields within an input line data record (for example, a customer 
number). Based on the results of the test, you can specify the action to be taken such as to change copy 
groups or page formats. This section provides: 


¢ An explanation of how conditional processing works 
* A detailed list of rules, restrictions, and considerations 


¢ Examples showing how conditional processing can be used to perform some commonly-requested 
functions 


General Description 


Conditional processing allows you to: 
* Test the input data using the CONDITION command. 
¢ Choose the copy group and page format to be used when printing the data. 


¢ Change to a different copy group or page format after the data has been read. You can specify that the 
new copy group or page format is to be used: 
— Before printing the current subpage 
— Before printing the current line 
— After printing the current line 
— After printing the current subpage 


Table 6}shows the tasks you may perform with conditional processing. 
Table 6. Conditional Processing Tasks 
Tasks Location of the Example 


Stack offset from previous jobs Jog Output Example” on page 129 


Use different print directions for front and i Output with Different Front and Back Print Directions” on 


uplex 
back sides of a sheet age 129 


Record reprocessing example 

Select different paper sources 
Multiple CONDITION commands 

Repeat PRINTLINE commands 


: 


Using Conditional Processing versus Normal Line Data Processing 


Normal line-data processing consists of: 
* Setting up the physical page environment by defining a copy group 
* Setting up the logical page environment by defining a page format 


Input records correspond to PRINTLINE commands that determine such things as where the input records 
are to be printed, which font to use and what print direction to use. Only one copy group and page format 
can be used for processing each input record. 


Conditional processing acts as a preprocessor by allowing you to test the input data before deciding which 
copy group and page format to use. Furthermore, you can change these specifications based on changes 
in the input data. Except for record reprocessing (explained on page i} once the copy group and 

page-format specifications have been made, conditional processing operates the same as normal line-data 


processing. 
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Note: The copy group and page format can also be changed by placing Advanced Function Presentation 
data stream (AFP data stream) Invoke Medium Map (IMM) and Invoke Data Map (IDM) structured 
fields in the input data. Use of these structured fields within the input print file causes results that 
differ from what is described in this section. Refer to Mixed Object Document Content Architecture 
Reference for information about these structured fields. 


Using Conditional Processing to Set Up the Environment 
Setting up the environment consists of selecting a copy group and a page format. 


Selecting a Copy Group 


Conditional processing can be used to select a copy group; it does not process the copy group. 


As described in}Chapter 2, “Using Form Definition Commands” on page 19] a form definition contains the 


controls that govern the physical page on which the print file is to be printed. A form definition can contain 
one or more copy groups as shown in the following diagram. 


PPFA Commands Resulting Form Definition 


FORMDEF FDEFX 


COPYGROUP CGA 


OVERLAY ... FIFDEFX 

SUBGROUP ... 

CGA 
COPYGROUP CGB Gap 

. CGC 

OVERLAY ... 

SUBGROUP ... 


COPYGROUP CGC 


OVERLAY ... 
SUBGROUP ... 


The first copy group within a form definition is always active when processing of a print file begins. To 
select a different copy group, use the CONDITION command. 


Note: By using the BEFORE SUBPAGE and BEFORE LINE parameters with conditional processing, you 
can change to a different active copy group before any lines have actually been formatted. 


Using the previous diagram as a reference, assume copy group CGB is active. The copy-group selections 
that can be made from a CONDITION command are: 

condname which starts the named copy group 

CURRENT which restarts copy group CGB 

= which restarts copy group CGB (alternate for CURRENT) 


NEXT which starts copy group CGC 
FIRST which starts copy group CGA 
NULL which does not make any change to the current copy group processing 
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which does not make any change to the current copy group processing (alternate for 
NULL) 


See |“Using the CONDITION Command to Select a Copy Group and a Page Format” on page 127|for more 


information on each of these options. 


Selecting a Page Format 


Conditional processing can be used to select an active page format. Selecting the page format does not 
change the basic rules for processing a page format: 


PRINTLINE commands are processed sequentially unless skip-to-channel or spacing commands are 
used. 


When the end of the page format is reached, processing returns to the first PRINTLINE command in the 
same page format. Processing does not continue with the next page format (if any) in the page 
definition. 


However, conditional processing does involve some additional considerations: 


Subpages 


A page format consists of one or more subpages. A subpage is defined by a group of PRINTLINE 
commands followed by an ENDSUBPAGE command. If an ENDSUBPAGE command is not defined 


then the entire page format is one subpage. See |“Subpage Description and Processing” on page 120}for 


more information. 
Record reprocessing 
Record reprocessing is used when input records are processed according to one set of copy-group and 


page-format specifications, and then new specifications are invoked for the same input records. See 
“Record Reprocessing Description and Processing” on page 121|for more information. 


As described in|Chapter 3, “Using Page Definition Commands for Traditional Line Data” on page 35} a 


page definition is a set of controls for formatting line-data and unformatted ASCII files (typically AIX) for 
printing on a logical page. A page definition can contain one or more page formats as shown in the 
following diagram. 


PPFA Commands Resulting Page Definition 


PAGEDEF PDEFX 
PAGEFORMAT PFMTA 


PRINTLINE ... 


PRINTLINE ... P1PDEFX 
PAGEFORMAT PFMTB PFMTA 

. PFMTB 

PRINTLINE ... PFMTC 


PRINTLINE ... 
PAGEFORMAT PFMTC 


PRINTLINE ... 
PRINTLINE ... 
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The first page format in the page definition is always active when processing of the print file begins. To 
invoke a new page format, use the CONDITION command. 


Note: By using the BEFORE SUBPAGE and BEFORE LINE parameters, it is possible to change to a 
different active page format before any lines have actually been formatted. 


Using the previous diagram as a reference, assume page format PFMTB is active. The page-format 
selections that can be made from a CONDITION command are: 

condname which starts the named page format 

CURRENT which restarts page format PFMTB 

= which restarts page format PFMTB (alternate for CURRENT) 


NEXT which starts page format PFMTC 

FIRST which starts page format PFMTA 

NULL which does not make any change to the current page format processing 

/ which — not make any change to the current page format processing (alternate for 
NULL 


See |“Using the CONDITION Command to Select a Copy Group and a Page Format” on page 127|for more 


information on each of these options. 


Subpage Description and Processing 


A page format consists of one or more subpages. A subpage is defined by a group of PRINTLINE 

commands followed by an ENDSUBPAGE command. If an ENDSUBPAGE command is not defined, then 

the entire page format is one subpage. The following considerations apply to subpages: 

¢ Subpages are necessary only with conditional processing. 
Multiple-up printing can be done with or without subpages being defined, but to change the page format 
or copy group at the level of one of the multiple-up pages, the multiple-up pages must be defined as 
subpages. In the following diagram, pages 1 through 4 can be defined as four separate subpages within 
one page format, or all defined within one subpage. However, in order to present the data on page 3 
(for example) in a format different from that used for pages 1 and 2, the four pages must be defined as 
subpages. 
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Pm 10in. > 
| | | | | 
A 
= Page 1 Page 3 
_ Record 1 Record8 
— Record2 Record9 
_ Record3 Record 10 
= Record 4 Record 11 
Bin. —_— 
— Page2 Page 4 
_ Record5 Record 12 
_ Record6 Record 13 
= Record 7 Record 14 
v 


* A subpage is processed sequentially starting from the beginning of the page format. Moving from one 
subpage to the next subpage is done by processing all the PRINTLINE commands for a given subpage, 
or by skipping (by means of the CHANNEL subcommand) or spacing to a PRINTLINE command in a 
different subpage. 


Note: Conditional processing cannot be used to select a subpage except by default. When a page 
format is started (or the current one is restarted), processing begins with the first PRINTLINE 
command of the page format. The effect is to select the first subpage in the page format. 


Record Reprocessing Description and Processing 


Record reprocessing is used when input records are processed according to one set of copy group and 
page format specifications, and then new specifications are invoked for the same input records. If the new 
specifications are to be applied using either the BEFORE SUBPAGE or the BEFORE LINE parameter, 
then the input records must be processed again using the new specifications instead of the original ones. 


Note: Input records are not printed twice; record reprocessing just changes the specifications used when 
formatting the records. 
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The process is shown in the following diagram. 


PPFA Commands 


PAGEFORMAT PFMTA ; 


PRINTLINE POSITION 1 IN 1 IN 
DIRECTION ACROSS 
REPEAT 5 3; 


CONDITION cond1 
START 2 LENGTH 1 
WHEN EQ 'B! 
BEFORE SUBPAGE 
NULL PAGEFORMAT PFMTB ; 


PAGEFORMAT PFMTB ; 


PRINTLINE POSITION 7 IN 1 IN 
DIRECTION DOWN 
REPEAT 5 3; 


CONDITION cond2 
START 4 LENGTH 1 
WHEN EQ 'Y! 
BEFORE SUBPAGE 
NULL PAGEFORMAT PFMTA ; 


Input Records 


>| > 


> 


Assume page format PFMTA is active. Under normal processing the first input record would print in the 
ACROSS direction, starting at a horizontal offset of 1 inch and a vertical offset of 1 inch. However, the 
third record satisfies the CONDITION statement and causes a new page format (PFMTB) to be started. 
Since CONDITION cond? specifies BEFORE SUBPAGE, the first two records must be reprocessed using 
page format PFMTB. As a result, all of the records are printed in a DOWN direction, starting at a 
horizontal offset of 7 inches and a vertical offset of 1 inch. 


If allowed to operate without restrictions, record reprocessing could force PSF into an infinite loop. For 


example: 
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PPFA Commands Input Records 


PAGEFORMAT PFMTA ; 


PRINTLINE POSITION 1 IN 1 IN 
DIRECTION ACROSS 


REPEAT 5 ; 
CONDITION cond1 
START 2 LENGTH 1 A Xx 
WHEN EQ 'B! 
BEFORE SUBPAGE A Xx 
NULL PAGEFORMAT PFMTB ; 
B Xx 
B 
PAGEFORMAT PFMTB ; . 
B Y 
PRINTLINE POSITION 7 IN 1 IN 


DIRECTION DOWN 
REPEAT 5 ; 


CONDITION cond2 
START 4 LENGTH 1 
WHEN EQ 'Y' 
BEFORE SUBPAGE 
NULL PAGEFORMAT PFMTA ; 


As in the previous example, page format PFMTA is initially active, and input record 3 results in the 
selection of page format PFMTB. However, page format PFMTB has a condition that checks position four 
for the character ‘Y’, which is satisfied by input record 5. Therefore, if there were no restrictions, page 
format PFMTA would again be selected, the input data would be reprocessed (starting with input record 1), 
leading to an infinite loop. 


To prevent this situation, after a BEFORE condition has been satisfied, all other BEFORE conditions are 


ignored until data has actually been formatted. See|“Record Reprocessing” on page 124|for detailed 
information on this restriction. 


Conditional Processing Rules, Restrictions, and Considerations 


Multiple Conditions 


Conditional processing supports: 

¢ Multiple PRINTLINE commands in each subpage 

¢ Multiple CONDITION commands on one PRINTLINE command 
¢ Multiple WHEN statements on one CONDITION command 


Rule 
For all these situations, the rule is the same; the first true condition is the one processed, and any 
following true conditions are ignored. 


Considerations 
Conditions are evaluated when they are encountered. For example, if a true condition has not been 


detected when an OTHERWISE statement is encountered, the OTHERWISE statement always results in a 
true condition. (An exception to this is explained in}“Interaction Between the CONDITION Command and 
the CHANNEL Subcommand” on page 125}) 


See |“Multiple CONDITION Commands” on page 132} for an example of multiple CONDITION commands. 
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Record Reprocessing 


Restrictions 
To prevent an infinite program loop, be aware that the following restrictions apply: 


1. When the conditional action is to take place before the current subpage: 


a. Actions specified as taking place before the current subpage are shut off until the current subpage 
end. 

b. Actions specified as taking place before the current line are shut off for one line (the first line 
processed in the subpage). 


2. When the conditional action is to take place before the current line, actions specified as taking place 
before the current subpage or before the current line are shut off for one line. 


Considerations 


° Ifa before subpage condition is true and causes a switch to a new page format, all before subpage 
conditions in the new page format are ignored. 


° Ifa before line condition is true and causes a switch to a new page format, all before subpage and 
before line conditions in the new page format are ignored until one line has been processed. 


The consequence of this is that, after a true condition, at least one line must be processed before the next 
before condition is considered. This can be confusing because a condition that would otherwise yield a 
true result can be ignored. 


See|“Record Reprocessing Example” on page 130}for an example of record reprocessing. 


Interaction Between a CONDITION Command and a REPEAT 
Subcommand 


See|“Interaction Between the CONDITION Command and the CHANNEL Subcommand?” on page 125] for 


what can appear to be an exception to the following rules. 


Rule for a CONDITION Command and a REPEAT Subcommand 
The REPEAT subcommand is used with the PRINTLINE command to specify the number of printlines 


(usually greater than one) that are to be constructed with the same specifications (font, direction, and so 
on). The CONDITION command is used to invoke conditional processing based on the data in a particular 
line. When the REPEAT and CONDITION commands are both specified for the same PRINTLINE 
command, every line described by the PRINTLINE command is checked for the given condition until either 
the condition is satisfied or there are no more lines described by the PRINTLINE command. 


Note: This is different from the way in which the CHANNEL and POSITION subcommands interact with 
the PRINTLINE command. These two subcommands apply only to the first line described by the 
PRINTLINE command. 


Rule for a CONDITION Command With an OTHERWISE Subcommand 

The REPEAT subcommand is used with the PRINTLINE command to specify the number of printlines 
(usually greater than one) that are to be constructed with the same specifications (font, direction, and so 
on). The CONDITION command is used to invoke conditional processing based on the data in a particular 
line. The CONDITION command includes one or more WHEN subcommands and may include an 
OTHERWISE subcommand. If an OTHERWISE is coded, and none of the preceding WHEN conditions are 
true, the OTHERWISE condition is always true. If an OTHERWISE command is not coded, it is treated as 
a null. 


Considerations 
For the situation where REPEAT and CONDITION with OTHERWISE are coded for the same PRINTLINE 


command, the first input line determines the processing to be performed. This happens because either one 
of the WHEN conditions or the OTHERWISE condition is always true for the very first line. 
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Interaction Between the CONDITION Command and the CHANNEL 
Subcommand 


Rule 
A condition is checked if its associated PRINTLINE command is actually processed. 


Note: ANSI carriage controls and machine (EBCDIC) carriage controls are processed differently. See the 
SPACE_THEN_PRINT subcommand on sete creer ena eee more information. 
ANSI A skip or space occurs before printing the line. 
Machine The line is printed and then skipping or spacing is done. 


For a CONDITION to be checked, it must be associated with the PRINTLINE command that is 
actually used for printing. 


ANSI Skipping Consideration 
The PRINTLINE command is not processed if a skip-to-channel-n character in the carriage control field 
causes the given PRINTLINE command not to be processed. 


If a data record contains a character ‘1’ (for example) in the carriage control field, and a PRINTLINE 
command has been specified with CHANNEL 1 subcommand, the data record is processed under the 
“new” PRINTLINE command (the one that specified CHANNEL 1). Any CONDITION associated with the 
“old” PRINTLINE command is ignored (never even checked). See the following diagram for an example of 
this. 


The character ‘1’ in the carriage-control field of the fifth input record causes a page end before condition 
cond? is ever checked. Thus, the fifth input record is processed using the first PRINTLINE command of 
the current page format. 


PPFA Commands Input Records 
Carriage Control 
PAGEFORMAT PFMTA ; | 
PRINTLINE CHANNEL 1 ; 1 2 3 4 5 6 
PRINTLINE ; 
PRINTLINE ; cA ! 
PRINTLINE ; tli inle 2 
PRINTLINE ; 
CONDITION cond1l L | N/E 3 
START 6 LENGTH 1 
WHEN EQ '5! L I |N]E 4 
AFTER SUBPAGE 
CURRENT NULL; Ty) bLy) I | NTE 5 


Considerations 
The PRINTLINE command is not processed if the PRINTLINE command is spaced over, for example, 
when multiple line spacing causes certain PRINTLINE commands to be bypassed. 


If the input-record carriage-control field specifies a double space before print (for example), and a 
CONDITION command is specified for the spaced line, the CONDITION is ignored (never checked). 
Because the OTHERWISE subcommand is part of a CONDITION command, the OTHERWISE 
subcommand is also ignored. 


This can be confusing. You might expect an OTHERWISE condition to be true if all other conditions have 
failed. In fact, the OTHERWISE condition can be true if it is associated with a PRINTLINE command that 


Chapter 6. Conditional Processing 125 


is actually processed. See the following diagram for an example of this. This assumes ANSI carriage 
controls have been specified for this print file. ANSI carriage control ‘0’ means space two lines before 
printing. 


The fifth input record contains data (character ‘5’ in the sixth position) that would normally satisfy the 
condition specified on the fifth PRINTLINE command. However, the character ‘0’ in the carriage control 
field of input record 4 causes the fifth PRINTLINE command to be ignored. The fifth input record is 
processed by the sixth PRINTLINE command; therefore, the condition is not satisfied. 


PPFA Commands Input Records 
—— Carriage Contro 
PAGEFORMAT PFMTA ; 
PRINTLINE CHANNEL 1 3; v1 2 3 4 5 6 
PRINTLINE 3; 
PRINTLINE ; Lj} I|N]E 1 
PRINTLINE 3; L | NIE 2 
PRINTLINE 3; 
CONDITION cond1l Ly) I|N]E 3 

START 6 LENGTH 1 

WHEN EQ '5' OF; L | N|E 4 

AFTER SUBPAGE 

CURRENT NULL; L | N/E 5 
PRINTLINE 3; ' lap 


WHEN CHANGE is Always False at Start of a Page Format 


Rule 

The WHEN CHANGE process compares the contents of a given field with the contents of the same field in 
the last record that was processed with the current page format and current condition. Whenever a page 
format is started (either by a condition that changes page formats or when processing of the data file 
begins), a WHEN CHANGE condition is always false because the previous record was not processed with 
the current page format. 


Note: The following meanings apply to the previous statement: 
changes switching to a page format that has a different name 


data file begins if conditional processing invokes the CURRENT data map, 
CHANGE information is retained 


Considerations 

Ensure that the WHEN CHANGE statement is processed before the switch to a new page format has 
been performed. See|'Multiple CONDITION Commands’ on page 132] for an example of how a 
combination of WHEN CHANGE BEFORE SUBPAGE and WHEN CHANGE AFTER SUBPAGE can lead 
to unexpected results. 


Relationship of CC and TRC fields to the START Subcommand 


Rule 

The position specified by the START subcommand of the CONDITION command is in reference to the 
start of the data record. The first one or two bytes of an input record may contain either both a 
carriage-control character (CC) or a table-reference character (TRC). However, these characters are not 
considered part of the data record and are not to be counted when determining the START subcommand 
value. In the following example, the field being checked is actually the seventh character of the input 
record, but is the sixth character of the data record. 
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PPFA Commands Input Records 
Carriage Control 
PAGEFORMAT PFMTA ; | 
PRINTLINE CHANNEL 1 ; 1 2 3 4 5 6 
PRINTLINE 3; 
PRINTLINE 3; Ly It|NTeE 1 
PRINTLINE 3; L | NIE 2 
PRINTLINE 3; 
CONDITION cond1 LJ i) N{E 3 
START 6 LENGTH 1 
WHEN EQ '5' O;L | N/E 4 
AFTER SUBPAGE 
CURRENT NULL; E | N/E 5 
PRINTLINE 3; : wie = 


Using the CONDITION Command to Select a Copy Group and a Page 
Format 


Rules 

1. Within the CONDITION command, a copy group and a page format can be specified by using either a 
specific name or a parameter (CURRENT or =, FIRST, NEXT) or NULL or / can be specified. The use 
of the NULL or / parameters differs from the use of the others: 


Others When any parameter other than NULL or / is specified, the specifications for the copy 
group or page format selected replace the current specifications. When the current 
specifications are replaced, the action is referred to as starting or restarting the copy 
group or page format. In AFP terminology, an Invoke Medium Map (IMM) command is 
generated for a copy group and an Invoke Data Map (IDM) command is generated for 
a page format. 


NULL or / When NULL or / is specified, no IMM or IDM is generated and processing continues 
as if no condition check was present. 


2. The COPYGROUP and the PAGEFORMAT parameters are positional. If both parameters are 
specified, the COPYGROUP parameter must be first. If you want only to specify the copy group, the 
PAGEFORMAT parameter can be omitted, or specified as NULL or /. However, if you want only to 
specify the page format, the COPYGROUP parameter must be specified as NULL or /. 


Considerations 


Starting or Restarting a Copy Group: When a copy group is started (or restarted), the remaining input 
data is forced to the start on the next sheet. Therefore, if duplex output was expected, but the copy group 
is restarted while processing the front side of a sheet, the remaining data starts on the front side of the 
next sheet rather than on the back side of the current sheet. 


See |“Duplex Output with Different Front and Back Print Directions” on page 129]for an example. 


Furthermore, observe that any copy group action except NULL restarts the page format (see the following 
item). 


Starting or Restarting a Page Format: When a page format is started (or restarted), the remaining input 
data is forced to the start on the next side. Furthermore, that data is processed starting with the first 
PRINTLINE command in the specified page format. This is true even if CURRENT is specified as the page 
format parameter. 
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Not Restarting a Copy Group: lf the copy group is not to be restarted, specify NULL or /. Do not 
specify COPYGROUP NULL or COPYGROUP /. 


The following example illustrates this point. The command sequence on the left invokes a copy group 
named NULL. The command sequence on the right leaves the current copy group active. 


Incorrect Format 


Correct Format 


CONDITION condname 
START ... 


WHEN... 
COPYGROUP NULL 


CONDITION condname 
START ... 


WHEN ... 
NULL 


Not Restarting a Page Format: lf the page format is not to be restarted, specify NULL or / (or omit the 


specification). Do not specify PAGEFORMAT NULL or PAGEFORMAT /. 


The following example illustrates this point. The command sequence on the left invokes a page format 
named NULL. The command sequence on the right leaves the current page format active. 


Incorrect Format 


Correct Format 


CONDITION condname 
START ... 


WHEN ... 
COPYGROUP CGA 
PAGEFORMAT NULL 


CONDITION condname 
START ... 


WHEN ... 
COPYGROUP CGA 
NULL 


Variable Length Records and the CONDITION Command 


Considerations 

The CONDITION command inspects a field that starts at a particular position and extends for a certain 
length. If the entire field is not available within the input record, the condition is always false. If the input 
file contains variable-length records, the record may not extend the full length specified by the START and 
LENGTH subcommands. In this way, a condition which seems as if it should be satisfied can actually fail. 


Truncation of Blanks and the CONDITION Command 

Considerations 

Truncation occurs when blank characters are removed from the end of records on the spool. If blank 
truncation is in effect, the result can be the same as if the input file contained variable-length records. 


Blank truncation is a consideration at the time the input records are passed to the print server. In the JES2 
environment, blank truncation occurs unless the BLNKTRNC=NO parameter is specified. In the JES3 


128 PPFA User's Guide 


environment, blank truncation occurs unless the TRUNC=NO parameter is specified as part of either the 
BUFFER or SYSOUT initialization statements. Blank truncation can affect conditional processing since a 
field could “disappear” by being truncated causing no WHEN/OTHERWISE clause to be executed. 


Conditional Processing Examples 


This section provides conditional processing examples. The examples are grouped into functionally similar 
applications and are increasingly complex. The examples provided are: 

¢ Jog output based on a change in the input data 

¢ Duplex output with different front and back print directions 

* Record reprocessing 

¢ Select paper from an alternate bin 

¢ Multiple CONDITION commands 


Jog Output Example 


This example shows how to jog the printed output, based on a change in the input data. 


Copy group CGJOG specifies JOG YES. Page format PFJOG contains a CONDITION command that 
checks for any change in positions 8 through 10. If a change is detected, copy group CGJOG is restarted. 
Observe that the only result is to start printing on a new sheet and to jog that sheet. 


;— Jog Output Example 


FORMDEF TJOG; 
COPYGROUP CGJOG JOG YES; 


PAGEDEF TJOG; 
PAGEFORMAT PFJOG WIDTH 11 IN HEIGHT 8.5; 
PRINTLINE REPEAT 50 
CHANNEL 1; 
CONDITION NUPAGE START 8 LENGTH 3 
WHEN CHANGE BEFORE SUBPAGE 
COPYGROUP CGJOG; 


Duplex Output with Different Front and Back Print Directions 


This example shows how to establish one print direction on the front side and a different print direction on 
the back side of a duplex sheet. 


The page definition in this example contains two page formats, each of which has a CONDITION 
statement that always returns a true value. The value is true because the character in position 1 always 
has a value greater than or equal to hexadecimal zero. Therefore, every time a page change occurs (front 
to back, or back to next front) a different page format is started. The different DIRECTION statements in 
the two page formats change the layout of the text on the page. 


Observe that the COPYGROUP parameter is specified as NULL. If a parameter other than NULL or / is 


specified for COPYGROUP, the copy group restarts every time a page change occurs. Because restarting 
a copy group forces data to a new sheet, duplex printing does not occur. 
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Duplex Output 


FORMDEF XMPDUP 
DUPLEX NORMAL; 


PAGEDEF XMPDUP WIDTH 8.5 HEIGHT 11.0; 
PAGEFORMAT P2FRONT DIRECTION ACROSS; 
PRINTLINE CHANNEL 1 POSITION 0.75 TOP; 
CONDITION GOTOBACK START 1 LENGTH 1 
WHEN GE X'00' AFTER SUBPAGE NULL PAGEFORMAT P2BACK; 
PRINTLINE REPEAT 59; 


PAGEFORMAT P2BACK DIRECTION UP; 
PRINTLINE CHANNEL 1 POSITION 0.25 TOP; 
CONDITION GOTOFRNT START 1 LENGTH 1 
WHEN GE X'00' AFTER SUBPAGE NULL PAGEFORMAT P2FRONT; 
PRINTLINE REPEAT 59; 


Record Reprocessing Example 

This example uses the BEFORE SUBPAGE function with record reprocessing because the copy group 
and page format cannot be determined until input record 3 for each subpage has been read. 

Notes: 

1. This example includes two subpages. 


2. The CONDITION command specifies that the action to be performed is NEWFORM. Therefore, if the 
condition is satisfied, the data in the current subpage is forced to start on the next form. If the data is 
already at the start of a new form, no action is performed. In other words, a blank page is not 
generated. 
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-— Record Reprocessing Example 


/* Page definition for 2-up printing */ 
/* Test field in line 3 of each subpage */ 
/* Eject to new sheet if the field changes. */ 


PAGEDEF REPROC 
WIDTH 10.6 HEIGHT 8.3 DIRECTION DOWN; 


PAGEFORMAT PFREPROC; 


/* Definition of first subpage */ 
PRINTLINE CHANNEL 1 

REPEAT 2 

POSITION MARGIN TOP; 


PRINTLINE REPEAT 1 
POSITION MARGIN NEXT; 
CONDITION EJECT 
START 5 LENGTH 5 
WHEN CHANGE BEFORE SUBPAGE 
NEWFORM; 


PRINTLINE REPEAT 40 
POSITION MARGIN NEXT; 
ENDSUBPAGE; 


/* Definition of second subpage */ 
PRINTLINE CHANNEL 1 

REPEAT 2 

POSITION 5.3 TOP; 


PRINTLINE REPEAT 1 
POSITION 5.3 NEXT; 
CONDITION EJECT; 


PRINTLINE REPEAT 40 
POSITION 5.3 NEXT; 
ENDSUBPAGE; 


Selecting Paper from an Alternate Bin Example 


This example selects the first sheet from the alternate bin and all other pages from the primary bin. This 
function is useful when special paper (Such as one having the company logo) is to be used for the first 
page of a document. 


Note: Bin selection is overridden by the printer should the form defined to each bin be the same form 
number. Only the primary bin is selected. 
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; Alternate Bin Example 


/* The form definition contains two copy groups -- */ 
/* ALTBIN - for the first page */ 
/*  PRIBIN - for all other pages */ 


FORMDEF BINEX 
DUPLEX NO; 
COPYGROUP ALTBIN BIN 2; 
COPYGROUP PRIBIN BIN 1; 


PAGEDEF BINEX 
WIDTH 8.3 HEIGHT 10.6; 


/* Pageformat for first page - bin 2 */ 


PAGEFORMAT FIRST; 
PRINTLINE CHANNEL 1 
POSITION MARGIN TOP; 
CONDITION GOTOPRIM START 1 LENGTH 1 
WHEN GE X'00' AFTER SUBPAGE 
COPYGROUP PRIBIN PAGEFORMAT REST; 
PRINTLINE REPEAT 59; 


/* Pageformat for all other pages - bin 1 */ 


PAGEFORMAT REST; 
PRINTLINE CHANNEL 1 
POSITION MARGIN TOP 
REPEAT 60; 


Multiple CONDITION Commands 


Two examples are shown here. The first example shows how two CONDITION commands can interact to 
give unintended results. The second example shows how to use the two CONDITION commands to 
achieve the correct results. 


Example 1 Multiple CONDITION Command—tincorrect Solution 

The example on page demonstrates how two CONDITION commands can interact to give unintended 
results. Specifically, one CONDITION command causes a change of page format and then a second 
CONDITION command inspects a field with a WHEN CHANGE subcommand. 


The purpose of condition: 


NEWREP Starts a new report on a new sheet of paper whenever the specified field 
changes and jogs the output so the report can be easily located. 


SHIFTB and SHIFTF Handles the situation where all four subpages of the front (or back) 
contain data. 


In this situation, the objective is to change the print direction of the text on 
the page. 


In the situation where both conditions seem to be true at the same time, the results may be unexpected. 


Note: Condition SHIFTB (or SHIFTF) takes effect after the current subpage and therefore precedes the 
before subpage processing defined by condition NEWREP. Because condition SHIFTB results in 
starting a new page format, condition NEWREP returns a false value, and the expected new report 
processing is not performed. 
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Example 2 Multiple CONDITION Command—Correct Solution 
The example on page differs from the one on page in two significant ways: 


* Because the page format for the back side is the first one defined in the page definition, it is the one 
that is initially active 

* Both CONDITION commands (NEWREP and SHIFTIT) specify that the action should happen before the 
current subpage has been processed 


When processing begins, condition NEWREP fails because this is a WHEN CHANGE condition and the 
page format has just been started. However, condition SHIFTIT returns a true result, and the NEXT page 
format (PFFRONT) is started. No lines have been formatted, so condition SHIFTIT has the effect of 
moving to the page format for the front side. 
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INCORRECT Solution Example 


FORMDEF XMPICO OFFSET 0 @ DUPLEX RTUMBLE JOG YES REPLACE YES; 
COPYGROUP CG1; 
OVERLAY OVLY1; 
OVERLAY OVLY2; 


SUBGROUP OVERLAY OVLY1 FRONT; 

SUBGROUP OVERLAY OVLY2 BACK ; 
PAGEDEF XMPICO REPLACE YES; 

FONT GT24; 

FONT GT12; 


/* Definition of pageformat for front side */ 
PAGEFORMAT PFFRONT WIDTH 11 IN HEIGHT 8.5 IN DIRECTION UP; 
SETUNITS 1 PELS 1 PELS LINESP 16 LPI; 
PRINTLINE REPEAT 1 CHANNEL 1 FONT GT24 POSITION 75 188; 
CONDITION NEWREP START 8 LENGTH 3 
WHEN CHANGE BEFORE SUBPAGE COPYGROUP CG1 PAGEFORMAT PFFRONT; 
PRINTLINE REPEAT 40 FONT GT24 POSITION 75 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT24 POSITION 1377 188; 
CONDITION NEWREP START 8; 

PRINTLINE REPEAT 40 FONT GT24 POSITION 1377 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT24 POSITION 75 1102; 
CONDITION NEWREP START 8; 

PRINTLINE REPEAT 40 FONT GT24 POSITION 75 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT24 POSITION 1377 1102; 
CONDITION NEWREP START 8; 
CONDITION SHIFTB START 1 LENGTH 1 

WHEN GE X'00' AFTER SUBPAGE NULL PAGEFORMAT PFBACK; 
PRINTLINE REPEAT 40 FONT GT24 POSITION 1377 NEXT; 
ENDSUBPAGE; 


/* Definition of pageformat for back side */ 
PAGEFORMAT PFBACK WIDTH 8.5 IN HEIGHT 11 IN DIRECTION ACROSS; 
SETUNITS 1 PELS 1 PELS LINESP 8 LPI; 
PRINTLINE REPEAT 1 CHANNEL 1 FONT GT12 POSITION 75 61; 
CONDITION NEWREP START 8; 
PRINTLINE REPEAT 40 FONT GT12 POSITION 75 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT12 POSITION 75 1335; 
CONDITION NEWREP START 8; 
CONDITION SHIFTF START 1 LENGTH 1 

WHEN GE X'00' AFTER SUBPAGE NULL PAGEFORMAT PFFRONT; 
PRINTLINE REPEAT 40 FONT GT12 POSITION 75 NEXT; 
ENDSUBPAGE; 
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-— CORRECT Solution Example 


FORMDEF XMPCOR OFFSET 0 @ DUPLEX RTUMBLE JOG YES REPLACE YES; 
COPYGROUP CG1; 
OVERLAY OVLY1; 
OVERLAY OVLY2; 


SUBGROUP OVERLAY OVLY1 FRONT; 

SUBGROUP OVERLAY OVLY2 BACK ; 
PAGEDEF XMPCOR REPLACE YES; 

FONT GT24; 

FONT GT12; 


/* The pageformat for the back side of the form is */ 
/* the first pageformat in the PAGEDEF. Therefore, */ 
/* it will initially be the active pageformat */ 
PAGEFORMAT PFBACK WIDTH 8.5 IN HEIGHT 11 IN DIRECTION ACROSS; 
SETUNITS 1 PELS 1 PELS LINESP 8 LPI; 
PRINTLINE REPEAT 1 CHANNEL 1 FONT GT12 POSITION 75 61; 
CONDITION NEWREP START 8 LENGTH 3 
WHEN CHANGE BEFORE SUBPAGE COPYGROUP CG1 PAGEFORMAT 
PFFRONT; 
CONDITION SHIFTIT START 1 LENGTH 1 
WHEN GE X'Q0' BEFORE SUBPAGE NULL NEXT; 
PRINTLINE REPEAT 40 FONT GT12 POSITION 75 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT12 POSITION 75 1335; 
CONDITION NEWREP START 8; 

PRINTLINE REPEAT 40 FONT GT12 POSITION 75 NEXT; 
ENDSUBPAGE; 


/* This is the pageformat for the front side of the form. */ 
PAGEFORMAT PFFRONT WIDTH 11 IN HEIGHT 8.5 IN DIRECTION UP; 
SETUNITS 1 PELS 1 PELS LINESP 16 LPI; 
PRINTLINE REPEAT 1 CHANNEL 1 FONT GT23 POSITION 75 188; 
CONDITION NEWREP START 8; 
CONDITION SHIFTIT START 1; 
PRINTLINE REPEAT 40 FONT GT24 POSITION 75 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT24 POSITION 1377 188; 
CONDITION NEWREP START 8; 

PRINTLINE REPEAT 40 FONT GT24 POSITION 1377 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT24 POSITION 75 1102; 
CONDITION NEWREP START 8; 

PRINTLINE REPEAT 40 FONT GT24 POSITION 75 NEXT; 
ENDSUBPAGE; 


PRINTLINE REPEAT 1 CHANNEL 1 FONT GT24 POSITION 1377 1102; 
CONDITION NEWREP START 8; 

PRINTLINE REPEAT 40 FONT GT24 POSITION 1377 NEXT; 
ENDSUBPAGE; 


Field Processing When PRINTLINEs Are Repeated 
The following examples show the effect of the [LINE | FIELD] parameter on REPEAT nr. 


The first PRINTLINE example uses FIELD type repetition. The second PRINTLINE example shows LINE 
type repetition. 
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Note: When LINE type repetition is used, SETUNITS LINESP may need to be set to a higher value to 
avoid over printing. 


REPEAT n type FIELD Example 


PAGEDEF rept01 WIDTH 8.0 IN 
HEIGHT 10.5 IN 
LINEONE 0.2 IN 0.2 IN 
DIRECTION ACROSS 
REPLACE YES; 


FONT normal CR10 SBCS ROTATION 0; 
FONT italic CI10 SBCS ROTATION 0; 
FONT bold CB10 SBCS ROTATION 0; 


SETUNITS LINESP 6 LPI; 


PRINTLINE POSITION 1.0 IN 1.0 IN 
DIRECTION ACROSS 
FONT bold 
REPEAT 3 FIELD; 
FIELD POSITION 0.0 IN 0.0 IN 
DIRECTION ACROSS 
FONT normal 
START * LENGTH 20; 
FIELD POSITION 2.5 IN 0.0 IN 
DIRECTION DOWN 
FONT normal 
START * LENGTH 20; 
FIELD POSITION 2.5 IN 2.5 IN 
DIRECTION BACK 
FONT normal 
START * LENGTH 20; 
FIELD POSITION 0.0 IN 2.5 IN 
DIRECTION UP 
FONT normal 
START * LENGTH 20; 
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-_ REPEAT n type LINE Example 


SETUNITS LINESP 3.0 IN; 


PRINTLINE POSITION 5.0 IN 1.0 IN 
DIRECTION ACROSS 
FONT bold 
REPEAT 3 LINE; 
FIELD POSITION 0.0 IN 0.0 IN 
DIRECTION ACROSS 
FONT normal 
START * LENGTH 203; 
FIELD POSITION 2.0 IN 0.0 IN 
DIRECTION DOWN 
FONT normal 
START * LENGTH 20; 
FIELD POSITION 2.0 IN 2.0 IN 
DIRECTION BACK 
FONT normal 
START * LENGTH 20; 
FIELD POSITION 0.0 IN 2.0 IN 
DIRECTION UP 
FONT normal 
START * LENGTH 203 


The next example shows Input Line Data. 


(Input) Line Data: 


Field Type Repeat 
Field Type Repeat 
Field Type Repeat 
Line Type Repeat 
Line Type Repeat 
Line Type Repeat 
Field Type Repeat 


Field Type Repeat 
Field Type Repeat 
Field Type Repeat 
Line Type Repeat 
Line Type Repeat 
Line Type Repeat 
Notice that the 


special effects are desired. 


Line Type Repeat 


Generally, this type of repeat needs a 


...So that lines 


is based on the 


won't overlap! 


Sample Output 


When the previous example is processed by the print server, the following output is printed. 


Field Type Repeat 
Field Type Repeat 
Field Type Repeat 
Line Type Repeat 
Line Type Repeat 
Line Type Repeat 


fields are repeated 
instance of the same field, and not the 


printline. This 


printline. Good 
SETUNITS LINESP 
This is 


Field Type Repeat 
Field Type Repeat 
Field Type Repeat 
Line Type Repeat 
Line Type Repeat 
Line Type Repeat 
based on the prior 
has advantages if 


for sales tickets. 


command... 


SETUNITS LINESP 3 IN 
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Field Type Repeat 


Field Type Repeat 
Field Type Repeat 


Field Type Repeat 


qeedey edAy, pTteta 
qeodey edAy, pleta 
qeodey edAy, pleta 


qeodoy odAL pleta 
qeodoy odAL prTeta 
qeodoy odAL preta 


Field Type Repeat 
Field Type Repeat 


Line Type Repeat 


Line Type Repeat 


qeedey edAy eutt 


Line Type Repeat 


qeodey edAy sutt 


Line Type Repeat 


qeodey eddy, sutt 


qeodey oedAZ outyt 


Line Type Repeat 


qeedey edAy, eutyt 


Line Type Repeat 


qeodey odAZ sutt 
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Field Type Repeat 


i Ams 
instance of the same @Ov+.0 
special effects are £<£.%f. 
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peqesedez ere spTets 


Line Type Repeat 


for sales tickets. 


Generally, this type 
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Chapter 7. N_UP Printing 


With N_UP printing, which is defined in the form definition, you can print up to four pages on a sheet of 
paper in simplex mode and up to eight pages in duplex mode. Each of these pages are independent, 
allowing use of different page formats and copy groups for each page. This provides significantly more 
flexibility and function than the traditional multiple-up capability which is defined in the page definition. 
Refer to['N_UP Compared! to Multiple-up on page 160]for more differences between N_UP printing and 


multiple-up printing. 


There are two levels of N_UP:? 
* basic N_UP supported by older AFP printers: 3825, 3827, 3828, 3829, 3835, and 3900-001. 
* enhanced N_UP supported by printers with the Advanced Function Common Control Unit (AFCCU). 


N_UP Partitions and Partition Arrangement 


A key concept in N_UP printing is the partition. In both basic and enhanced N_UP, each sheet of paper is 
divided into equal size areas called partitions. Pages are placed in these partitions in sequential order in 
basic N_UP. Pages are placed in relation to one or more of these partitions in enhanced N_UP. Knowing 
the partition arrangement is critical to designing applications using N_UP. 


Note: If you are using basic N_UP printing with PSF set to DATACK=BLOCK, data must fall within the 
boundary of the partition. Any data placed outside the edge of the partition boundary is not printed, 
and no error message is generated. However, enhanced N_UP printing allows pages to overlap 
partitions. The only limits are that the pages must not extend beyond the boundaries of the physical 
sheet, and the pages must not exceed the total number of N_UP partitions specified for the sheet. 


The number, size, and position of partitions are determined by three things: 
¢ the N_UP value (1, 2, 3, or 4) 

e the size and shape of the sheet of paper 

¢ the form definition presentation options, PRESENT and DIRECTION 


When printing in duplex mode, the same number of partitions is also defined for the back of the sheet. For 
normal duplex, back partitions are placed as if the sheet were flipped around its right side or y-axis. For 


tumble duplex, they are placed as if the sheet were flipped around its top edge, or x-axis. See|Figure 74 
ion page 143]/and|Figure 75 on page 144/for illustrations of duplex partitions. 
Figure 73 on page 142/through|Figure 76 on page 145}show the partition arrangement that results from 


every combination of N_UP value, paper size, and presentation option. 


Use these figures to determine how your N_UP application is formatted by the printer. In the figures, each 
equal-sized partition has a number indicating its default presentation sequence. The origin for each 
partition is in the same relative position as the origin point shown for the medium. This point serves as the 
top left corner for a page printed in the ACROSS (or 0°) printing direction [Figure 73 on page 1421 through 
Figure 76 on page 145)also shows the way data formatted in the DOWN printing direction is printed when 
you use a DOWN copy group. 


2. You must have the correct level of PPFA to generate basic or enhanced N_UP commands and the correct level of PSF for your 
operating system to drive the printer in the basic or enhanced N_UP mode. 
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Across Down with Down Data 
Portrait Landscape Portrait Landscape 


Medium origin 
=—— _ Orientation of X axis on the medium 


Figure 73. N_UP 1 Partition Arrangement 
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Across Down with Down Data 
Portrait Landscape Portrait Landscape 


=) 


Narrow 
Fanfold 


Medium origin 
=——~_ Orientation of X axis on the medium 


Figure 74. N_UP 2 Partition Arrangement 
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Across Down with Down Data 


Portrait Landscape Portrait Landscape 


me 


Narrow 
Fanfold 


Legend: = Medium origin 
=—— © Orientation of X axis on the medium 


Figure 75. N_UP 3 Partition Arrangement 
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Across Down with Down Data 
Portrait Landscape Portrait Landscape 


Wide 
Fanfold 


Fanfold 


Medium origin 
=——~_ Orientation of X axis on the medium 


Figure 76. N_UP 4 Partition Arrangement 
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Basic N_UP Printing 


You can specify the N_UP subcommand on either the FORMDEF or COPYGROUP commands in the form 
definition. |Figure 77}|shows the subcommands and parameters enabled with basic N_UP printing. 


FORMDEF Subcommand 


[INVOKE—SHEET—— 
>> H >< 
N_UP. | 


INVOKE NEXT | 
| Fron 
BACK— 


BwNr re 


vy 
OVERLAY Subcommand [- 


OVERLAY Subcommand: 

--OVROTATE—0: 
| —OVERLAY—name 7 7 
_x-pos - y-pos PARTITION '_OVROTATE 90. 

180 
270 


COPYGROUP Subcommand 
INVOKE—SHEET: 


>>. H >< 


N_UP: 1 INVOKE NEXT 
2 | Fron 
3 BACK— 


4 ad OVERLAY Subcommand 


OVERLAY Subcommand: 


r—-OVROTATE—O 
| —OVERLAY—name Al a | | 
_x-pos - y-pos ‘PARTITION '_OVROTATE 90 
180 
270 


Figure 77. Subcommands for Basic N_UP Printing 


The N_UP subcommand divides the medium into one, two, three, or four partitions, as described in|*N_UP| 
Partitions and Partition Arrangement” on page 141] The OVERLAY subcommand prints a page overlay in 


each partition at a specified offset from the page origin or the partition origin. For more information about 
The INVOKE subcommand controls the action that occurs if you invoke a new copy group. You can invoke 
copy groups using conditional processing in the page definition or by including an Invoke Medium Map 
(IMM) structured field in the print data. The default action is to eject to a new sheet. By specifying an 
INVOKE subcommand on a COPYGROUP command, you can instead eject to a new N_UP partition, 


which may be on the same sheet. If printing in duplex mode, you can specify whether to eject to a partition 
on the front or back side of the sheet. 


You must use page overlays instead of medium overlays if you want to change overlays while ejecting to a 
new partition. PSF honors the NEXT, FRONT, and BACK values of the INVOKE subcommand only if the 
new copy group has the same medium modifications as the previous copy group. Medium modifications 
include duplexing, bin, page offset, N_UP values, presentation, direction, and medium overlays. If any of 
these modifications differ, PSF ejects to a new sheet when the copy group is invoked. 
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By combining INVOKE with the N_UP OVERLAY subcommand, you can place different page overlays in 
different partitions when you change copy groups. This is illustrated in|“Basic N_UP Example 1: Using 
INVOKE and OVERLAY” 


The following examples show the use of basic N_UP. Because each example builds on the previous one, 
read them in sequential order to better understand basic N_UP. All the pages used in the examples are 
formatted in the ACROSS printing direction. Their orientation on the media is the result of using the 
available PRESENT and DIRECTION combinations in the FORMDEF command. 


Basic N_UP Example 1: Using INVOKE and OVERLAY 


Partition 1 Partition 2 
sheet Select copy group A. 
Select page format A. 
Write data for page 1. 
' Select copy group B. 
OverlayA ‘ Overlay B Select page format B. 
Page Format A :Page Format B Write data for page 2. 
Partition 1 Partition 2 
Sheet 2 
Write data for page 3. 
Write data for page 4. 
Overlay B Overlay B 
Page Format B :Page Format B 
Partition 1 Partition 2 
Sheet 3 
Write data for page 5. 
Select copy group A. 
OverlayB | OverlayA Select page format A. 
Page Format B: Page Format A Write data for page 6. 


Figure 78. Basic N_UP Example 1: Using INVOKE and OVERLAY 
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FORMDEF TWOUPS ; 


COPYGROUP A 
NUP 2 
OVERLAY A 
INVOKE NEXT ; 


COPYGROUP B 
NUP 2 
OVERLAY B 
INVOKE NEXT ; 


Figure 79. Form Definition for Basic N_UP Example 1 


Figure 78 on page 147/shows the INVOKE and OVERLAY functions of basic N_UP printing. Specifying 


INVOKE NEXT on the COPYGROUP command ensures that when the copy group is invoked by an 
Invoke Medium Map (IMM) structured field with conditional processing, the next page is placed in the next 
partition of the N_UP form. 


The OVERLAY subcommand specifies a page overlay, which can be positioned relative to the page origin 
or relative to the partition origin. In basic N_UP, the OVERLAY subcommand prints the overlay with the 
page data in every partition on the sheet. However, as shown in this example, using INVOKE NEXT allows 
the application to use different overlays in different partitions. 


Example 1 has been defined as N_UP 2 simplex with the default PORTRAIT ACROSS presentation, 
which results in the partitions illustrated in The application uses different page 
formats on different application pages. With N_UP, changing page formats ejects to the next partition, just 
as it ejects to a new page in applications without N_UP. 


The application also needs different overlays on different pages. Because the overlays are specified on 
N_UP in the COPYGROUP subcommand, the application accomplishes this by changing copy groups. 
Without the INVOKE subcommand, changing the copy group forces an eject to a new physical sheet. 
However, because INVOKE NEXT is specified, the eject is to the next partition. Changing to copy group B 
after page 1 is written places page 2 in partition 2 of the same physical sheet. If the change is made after 
a page is placed in partition 2, the eject to the next partition is to partition 1 of the next sheet. The page is 
printed with the overlay specified in the new copy group. 


Notes: 


1. The pages in this example are line-format print data, formatted using a page definition. The example 
would be the same for MO:DCA data, except that page formats would not be used. 


2. You can select the copy groups and page formats by including IMM and IDM structured fields in the 
print data or by using conditional processing in the page formats. 


3. Overlays can be defined as page overlays in the page definition or in the form definition N_UP or 
PLACE subcommands. Overlays can also be defined as medium overlays in the form definition 


SUBGROUP command. If you want to change overlays when ejecting to a new partition, use page 
overlays instead of medium overlays. See}|“Medium Overlays and Page Overlays” on page 159} for 


information about page and medium overlays. 
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Basic N_UP Example 2: Normal Duplex 
Figure 80}shows the partition order for duplexed pages. This figure also shows the partitions into which the 


Partition 1 Partition 2 Partition 1 Partition 2 


Front of Sheet Back of Sheet 


Partition 2 Partition 1 


Back of Sheet 


Front of Sheet 


Partition 1 Partition 2 


Figure 80. Basic N_UP Example 2: Normal Duplex 


FORMDEF NUPDUP 
NUP 2 

PRESENT PORTRAIT 
DIRECTION ACROSS 
DUPLEX NORMAL ; 


Figure 81. Form Definition for Basic N_UP Example 2: Normal Duplex 


sheet is divided for N_UP 2 with PORTRAIT presentation and ACROSS direction. With normal duplex, the 
sheet is rotated around its y-axis, which is the right edge of the sheet. The result is that partition 2 for the 

back side of the sheet is on the back of partition 1 for the front side, and page 4 is on the back of page 1. 
The tops of pages 3 and 4 are aligned with the tops of pages 1 and 2. 
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Basic N_UP 2 Example 3: Tumble Duplex 
shows the partition order for tumble duplex pages. This figure also shows the partitions into 


Partition 1 Partition 2 


Back of Sheet 


Partition 1 Partition 2 


Back 
of Sheet 


Front 


of Sheet 
Partition 1 Partition 2 


Front of Sheet 


Partition 1 Partition 2 


Figure 82. Basic N_UP 2 Example 3: Tumble Duplex 


FORMDEF NUPTUM 
NUP 2 

PRESENT PORTRAIT 
DIRECTION ACROSS 
DUPLEX TUMBLE ; 


Figure 83. Form Definition for Basic N_UP 2 Example 3: Tumble Duplex 


which the sheet is divided for N_UP 2 with PORTRAIT presentation and ACROSS direction. With tumble 
duplex, the sheet is rotated around its x-axis, which is the top of the sheet. The result is that partition 1 of 
the back of the sheet falls on the back of partition 1 for the front, and page 3 falls on the back of page 1. 


The tops of pages 3 and 4 are aligned with the bottoms of pages 1 and 2. For more information about 
normal and tumble duplex printing, refer to |“Normal Duplex and Tumble Duplex” on page 13 
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Enhanced N_UP Printing 


Enhanced N_UP is supported on AFP continuous forms printers. In addition to all the function of basic 
N_UP, enhanced N_UP includes the powerful PLACE subcommand. 


Using the PLACE subcommand, you can place pages in the partitions in any sequence, specify unique 
overlays for each page, and rotate both the page and the overlays in the partitions. You can place multiple 
pages in the same partition and no pages in other partitions, and you can extend pages across partition 
boundaries. In short, you can place pages of any size at any location on the front or back of the sheet, in 
any orientation. The only limits are that the pages must not extend outside the boundaries of the physical 
sheet, and the pages must not exceed the total number of N_UP partitions specified for the sheet. 


You use a single PLACE command to place each page of data on the sheet. You must specify the same 
number of PLACE commands as the number of N_UP partitions for the sheet. This is required for error 
recovery and restart integrity. If you do not want to place as many pages as partitions, you can specify 
CONSTANT on a PLACE command to indicate that no data is to be placed in the partition. You can 
specify the OVERLAY subcommand with the CONSTANT subcommand to place overlays without user’s 
data. The syntax diagrams in[152]and[153]show the subcommands and parameters enabled with 
enhanced N_UP printing. 


For most applications, place constant overlays before placing data on the sheet. This is because the 
overlay is not actually placed until the next page of data is placed. If your application changes copy groups 
or runs out of pages on the sheet before reaching the constant overlay PLACE subcommand, the constant 
overlay is not printed. However, if you do not want the overlays to print in these cases, place the constant 
overlay after placing the page data. 
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FORMDEF 


>>. 


INVOKE—SHEET. 


>< 


N_UP 


BPwWNr re 


Y_1 QVERLAY Subcommand 


| INVOKE NEXT 
| Front 


BACK— 


Y_) PLACE Subcommand [- 


OVERLAY Subcommand: 


—OVROTATE—0—— 


| OVERLAY—name 


PLACE Subcommand: 


Lepos yao! Lpartition_! OVROTATE—~—90 


-180-] 
270 


(1) FRONT: 
| PLACE—n | | 
BACK CONSTANT. OFFSET—x-pos—y-pos OVERLAY Subcommand = 
--ROTATION—O VIEW— YES 
> | 
| 
__ROTATION 90 VT EW—NO- 
180 
-270— 
Notes: 


1 The use of the PLACE subcommand indicates enhanced N_UP printing. 


Figure 84. FORMDEF Subcommand for Enhanced N_UP Printing 
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COPYGROUP 


>>. 


INVOKE—SHEET 


>< 


| INVOKE 


N_UP 1 NEXT: 
2 FRONT 
3 LBACK— 
4 Y_4 OVERLAY Subcommand 
Y_) PLACE Subcommand [-— 
OVERLAY Subcommand: 
—OVROTATE—0—— 


| OVERLAY—name 


PLACE Subcommand: 


Lies - iice| L partition! _QVROTATE—-—90 


-180-] 
270 


(1) FRONT: 
| PLACE—n | | 
BACK CONSTANT. OFFSET—x-pos—y-pos OVERLAY Subcommand = 
--ROTATION—O VIEW— YES 
> | 
| 
__ROTATION 90 VIEW—NO: 
180 
~270— 


Notes: 


1 The use of the PLACE subcommand indicates enhanced N_UP printing. 


Figure 85. COPYGROUP Subcommand for Enhanced N_UP Printing 


The following examples show enhanced N_UP printing. Read these examples in sequence to better 
understand enhanced N_UP printing. 
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Enhanced N_UP Example 1: Using PLACE 


Partition 2 Partition 1 


Back of Sheet 
(Inside of folded booklet) 


Write data for page 1. 
Write data for page 2. 
Write data for page 3. 


Write data for page 4. 
Back of : Front of 


Booklet Booklet 
Partition 1 Partition 2 
Figure 86. Enhanced N_UP Example 1: Using PLACE 


FORMDEF BOOKLT DUPLEX NORMAL 
N_UP 2 
/* Page 1 */ PLACE 2 FRONT 
/* page 2 */ PLACE 1 BACK 
/* Page 3 */ PLACE 2 BACK 
/* Page 4 */ PLACE 1 FRONT 3; 


Figure 87. Form Definition for Enhanced N_UP Example 1 


Figure 86} shows the function of the PLACE subcommand in specifying the sequence of partitions into 
which pages are placed. This example is N_UP 2 duplex. The default partition sequence is from left to 


right. Notice that when printing in normal duplex, partition 1 on the back of the sheet aligns with partition 2 
on the front of the sheet. See|“Basic N_UP Example 2: Normal Duplex” on page 149} and|“Basic N_UP 2 
Example 3: Tumble Duplex” on page 150|for information on N_UP duplex partitions. 


For this booklet, you do not want to print pages in the default order: partitions 1 and 2 on the front, 
followed by partitions 1 and 2 on the back. Instead, print the pages so that when the sheet is folded, you 
have a booklet, with page 1 on the front outside of the booklet, pages 2 and 3 inside the folded booklet, 
and page 4 on the back outside of the booklet. The form definition shown in [Figure 87|uses the PLACE 
subcommand of enhanced N_UP to place pages in the partitions in the order needed to accomplish this. 
The application writes the pages in order, page 1 through page 4, and the N_UP form definition provides 
the correct sequencing in the partitions. 
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Enhanced N_UP Example 2: Using CONSTANT and OVERLAY 


Partition 2 Partition 1 
Sheet 1 


 g yeuwo-+ abe 
a keyerno , gq Aeano 


G 
1 
/ 
i 


yoeg / | ueweyels 
juejsuog  jogebed 


Select copy group PAGE1. 
Back of Sheet Select page format PAGE1. 
Write data for page 1. 


Page 2 of Front of Sheet 


Statement 1 


Page 1 of 


Sieenr Select copy group PAGEON. 


Write data for page 2. 
Write data for page 3. 


OverlayA : OverlayB 
Page Format A‘ Page Format B 
Partition 1 Partition 2 


Partition 2 Partition 1 
Sheet 2 


9 Aeyano 


yoeg 
yueig =, = jueysuog 


Write data for page 4. 
Back of Sheet 


Page 1 of Front of Sheet 
Statement 2 Select copy group PAGE1. 
Select page format PAGE1. 
Write data for page 1. 


Page 4 of 
Statement 1 


Overlay A 


Overlay B 
Page Format B; Page Format A 


Partition 1 Partition 2 
Figure 88. Enhanced N_UP Example 2: Using CONSTANT and OVERLAY 
FORMDEF STATMT DUPLEX NORMAL ; 


COPYGROUP PAGE1 
INVOKE BACK 


NUP 2 

PLACE 2 BACK CONSTANT OVERLAY C 
PLACE 1 FRONT OVERLAY A 

PLACE 1 BACK CONSTANT OVERLAY C 


PLACE 2 FRONT OVERLAY A; 


COPYGROUP PAGON 
INVOKE NEXT 


N_UP 2 
PLACE 1 FRONT OVERLAY B 
PLACE 2 BACK OVERLAY B 
PLACE 2 FRONT OVERLAY B 
PLACE 1 BACK OVERLAY B ; 


Figure 89. Form Definition for Enhanced N_UP Example 2 
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[Figure 88 on page 155] [Figure 88 on page 155] on page 155] introduces the CONSTANT subcommand of enhanced N_UP and shows the 
functions of the PLACE subcommand, which was described in |‘Enhanced N_UP Example 1: Using Enhanced N_UP Example 1: Using N_UP Example 1: Using 

IPLACE” on page 154|and the INVOKE subcommand, which was described in|“Basic N_UP Example 1: 

Using INVOKE and OVERLAY” on page 147, Using INVOKE and OVERLAY” on page 147, and OVERLAY” on page 147] This figure represents a user application that is printing 
customer statements using the values N_UP 2 duplex. The PLACE subcommand places the pages in the 
correct order for post-processing equipment to cut the sheets into individual pages and interleave them to 
produce sequential pages. The INVOKE subcommand guarantees that one customer’s statement is never 
printed on the back side of another customer's statement. The N_UP 2 subcommand, combined_with the 


default PORTRAIT ACROSS presentation, divides the sheet into the two partitions illustrated in|Figure 88 
lon page 155] page 155 


In |Figure 88 on page 155} page 1 of each customer’s statement is printed with overlay A. The back side of 
page 1 is a constant overlay, with no user’s data. The remaining pages of each customer's statement are 
printed with overlay B. 


The copy groups place the required overlays on both the right and left halves of the sheet, so that a new 
customer statement can begin on either half of the sheet. COPYGROUP PAGON assigns overlay B to all 
partitions on the sheet. COPYGROUP PAGE1 assigns overlay A to all front partitions and overlay C to all 
back partitions. The CONSTANT parameter used with OVERLAY C means that no user’s data is printed in 
the partition with the overlay. To guarantee that the constant overlay prints whenever page 1 is printed, the 
PLACE subcommand for the constant overlay is specified before the PLACE subcommand for page 1 
print data. The INVOKE subcommand specifies BACK to ensure that the overlay is printed on the back of 
the partition. 


In the application shown in|Figure 88 on page 155] the copy group is changed to PAGON after page 1 is 


printed. Because the constant overlay and page 1 were printed with the first two PLACE commands of 
copy group PAGE, the third PLACE command in new copy group is used for the next page. Page 2 of 
statement 1 is placed in partition 2 front, as specified in the third PLACE subcommand of copy group 
PAGON. 


After the fourth and last page of statement 1, the copy group is changed back to PAGE1 to print page 1 of 
statement 2. Page 4 of statement 1 printed in front partition 1 using the first PLACE subcommand of copy 
group PAGON. N_UP selects the second PLACE subcommand of copy group PAGE1: PLACE 1 FRONT. But 
the INVOKE subcommand for copy group PAGE1 specifies BACK. N_UP continues sequentially through 
the PLACE subcommands of copy group PAGE1 until it finds a BACK partition. This is the third PLACE 
subcommand: PLACE 1 BACK CONSTANT OVERLAY C. The constant overlay is placed in partition 1 on the back 
of the sheet, then page 1 of the new customer's statement is printed using the next PLACE subcommand: 
PLACE 2 FRONT on the front side of the constant overlay. 


Note: You can use NEXT, FRONT, or BACK on the INVOKE subcommand only when switching between 
copy groups that have identical medium modifications. This includes identical N_UP values and an 
identical number of PLACE subcommanas. If the copy groups have different values, the INVOKE 
command causes an eject to a new physical sheet. 
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Enhanced N_UP Example 3: Asymmetric Pages 


Sheet 1 Back of Sheet 


yoeg ; 
juejsuoy atasa ear 


aa 


g AeyiaAo & ebed 


Select copy group FIRST. 
Write page 1. 
Write page 2. 
Write page 3. 
Write page 4. 
Write page 5. 
Write page 6. 
Overlay A Write page 7. 


Sheet 2 


Back of Sheet 


9 Aeyenc jueysuog 


Select copy group SECOND. 
Write page 8. 
Write page 9. 
Write page 10. 
Write page 11. 


Figure 90. Enhanced N_UP Example 3: Asymmetric Pages 


[Figure 90] shows the flexibility and power of enhanced N_UP printing. With enhanced N_UP printing, you 
can place pages relative to any partition on the sheet, front or back, in any sequence. Pages are not 
limited by partition boundaries. The only limitations are that pages must not print outside the physical form 
boundaries, and you cannot place more pages on a sheet than the number specified in the N_UP 
subcommand. For an N_UP 4 duplex page, the limit is eight pages total on front and back sides 
combined. For N_UP 3 duplex, the limit is six pages on the front and back combined. 
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FORMDEF ASYMET DUPLEX NORMAL ; 


COPYGROUP FIRST 
PRESENT LANDSCAPE DIRECTION ACROSS 
N_UP 4 


/* Constant*/ PLACE 1 BACK OFFSET 4 © CONSTANT OVERLAY B 
/* Page 1+*/ PLACE 1 FRONT OFFSET 0 O Overlay A 

/* Page 2 */ PLACE 1 FRONT OFFSET 12 0 

/* Page 3 */ PLACE 1 BACK OFFSET 0 0 

/* Page 4 */ PLACE 1 FRONT OFFSET 12 4 

/* Page 5 */ PLACE 1 BACK OFFSET 0 4 

/* Page 6 */ PLACE 1 FRONT OFFSET 12 8 

/* Page 7 */ PLACE 1 BACK OFFSET 0 8; 


COPYGROUP SECOND 
PRESENT PORTRAIT DIRECTION ACROSS 
N_UP 3 

/* Constant*/ PLACE 
/* Page 8 */ PLACE 
/* Page 9 */ PLACE 
/* Page 10 */ PLACE 
/* Page 11 */ PLACE 
/* 6th place */ PLACE 


BACK OFFSET 
FRONT OFFSET 
FRONT OFFSET 
FRONT OFFSET 
FRONT OFFSET 
BACK OFFSET 


CONSTANT OVERLAY C 


1 
1 
1 
1 
1 
1 


DAnDDTOO 
OofoOorooe 


CONSTANT ; 


Figure 91. Form Definition for Enhanced N_UP Example 3 


To achieve the asymmetrical page placement shown in this example, place all the pages relative to the 
origin of partition 1 on the front or the back side of the sheet. You can place the pages relative to the 
origin of any of the partitions, but using partition 1 simplifies the calculations for page positions. 


With N_UP 4, the default PORTRAIT presentation and ACROSS direction place the origin at the top right 
of the partition on wide, continuous-form paper. In this example, specifying LANDSCAPE ACROSS sets 
the origin at the top-left corner, to achieve the correct page arrangement. 


The coding of the form definition for example 3 is shown in[Figure 91] Copy group FIRST specifies N_UP 
4, which requires eight PLACE subcommands for the duplex page. Observe that the constant overlay B on 
the back of the sheet represents one of the eight PLACE subcommands. COPYGROUP SECOND used 
for the second sheet specifies N_UP 3. You must use six PLACE subcommands. Four pages are placed 
on the front side, and a constant overlay is placed on the back, using five of the six PLACE 
subcommands. A CONSTANT page is specified without an overlay to fill the sixth PLACE subcommand. 
Nothing is printed with this PLACE subcommand, but it is required to ensure a correct internal page count 
for recovery and restart. 


Note: In each copy group, the PLACE subcommand for the constant overlay is placed in front of all the 
PLACE subcommands for page data. This placement ensures that the constant overlay prints if any 
pages are printed on the sheet. Otherwise, if you change copy groups or run out of pages before 
the PLACE command for the constant overlay, the overlay does not print. 


Additional N_UP Considerations 


N_UP can affect the scope of other PPFA commands that operate on a page or a medium. 


COPIES The COPIES subcommand in the SUBGROUP of the form definition operates on the 
physical medium. When you specify five copies using N_UP 2, you get five sheets of the 
N_UP 2 data. 

SUPPRESSION 


The SUPPRESSION subcommand in the SUBGROUP of the form definition operates on 
the physical medium. The suppression names in the SUBGROUP operate on all N_UP 
pages on the sheet. 
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OVERLAY You can specify an OVERLAY subcommand in multiple places in the form definition and 


can also specify an overlay in the page definition. The result is either a page overlay or a 
medium overlay. See |“Medium Overlays and Page Overlays”|for a description of the 
differences between these commands and the uses of these overlays. 

PRESENT DIRECTION 
You use the PRESENT and DIRECTION subcommands of the form definition with the 


N_UP subcommand to determine partition arrangement. These commands, which are 
described in this update guide, now affect all N_UP printers, including cut-sheet printers. 


CONDITION You can use the CONDITION command of the page definition with N_UP just as you use 
it with non N_UP jobs. However, the NEWSIDE and NEWFORM parameters may operate 
differently than you expect. NEWSIDE, which is equivalent to invoking a new page format, 
ejects to the next partition, which may not be on a new side of an N_UP sheet. 
NEWFORM, which is equivalent to invoking a new copy group, ejects to a new sheet with 
basic N_UP. The effect with enhanced N_UP depends on the coding of the INVOKE 
subcommand. 


Medium Overlays and Page Overlays 


An AFP overlay can be used as a page overlay or as a medium overlay. Different actions are performed 
on these two different types of overlays. Page overlays apply to the page and are placed relative to the 
page origin. Medium overlays always apply to the entire medium and are placed at the medium origin. 
When used with N_UP, the medium overlay still applies to the entire sheet of paper, not to the individual 
partitions. 


The same overlay can be either a page overlay or a medium overlay, depending on the method used to 
invoke it for printing. An overlay invoked by a page definition or by an Include Page Overlay (IPO) 
structured field is always a page overlay. An overlay invoked by a form definition without N_UP is always a 
medium overlay. When N_UP is specified in the form definition, you can specify commands to invoke a 
page overlay. The examples below show the ways in which overlays can be invoked. 


PAGEDEF EXMPL1 ; 
PAGEFORMAT P2EXMPL1; 


OVERLAY EXMPL1; /* Allows this page overlay to be */ 
/* invoked by an IPO structured field */ 
PRINTLINE REPEAT 60; /* coded in the print data */ 


Figure 92. Page Overlay Invoked by an IPO Structured Field 


PAGEDEF EXMPL2 ; 
PAGEFORMAT P2EXMPL2; 
OVERLAY EXMPL2; /* Optional. Stores overlay for reuse */ 
PRINTLINE REPEAT 1 

POSITION 1 IN 1 IN 

OVERLAY EXMPL2 /* Prints overlay if data prints on printline */ 

-1 IN -1 IN ; /* Positions overlay relative to printline */ 

PRINTLINE REPEAT 50; 


Figure 93. Page Overlay Invoked by a PRINTLINE Command 
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FORMDEF EXMPL3 ; 
COPYGROUP F2EXMPL3 
DUPLEX NORMAL ; 


OVERLAY XMPL3F; /* Allows SUBGROUP to invoke overlay +*/ 
OVERLAY XMPL3B; /* Allows SUBGROUP to invoke overlay */ 
SUBGROUP FRONT 

OVERLAY XMPL3F; /* Prints overlay on front of every form */ 
SUBGROUP BACK 

OVERLAY XMPL3B; /* Prints overlay on back of every form */ 


Figure 94. Medium Overlay Invoked by a Form Definition 


FORMDEF EXMPL4 ; 
COPYGROUP F2EXMPL4 


N_UP 2 
OVERLAY EXMPL4 /* Prints overlay with page in every */ 
00 ; /* Partition at the page origin (0,0) */ 


Figure 95. Page Overlay in a Simple N_UP Form Definition 


FORMDEF EXMPL5 ; 
COPYGROUP F2EXMPL5 


N_UP 2 
PLACE 1 
OVERLAY XMPL51 /* Prints overlay in Partition 1 */ 
0 © PARTITION /* Places it relative to Partition */ 
PLACE 2 
OVERLAY XMPL52 /* Prints overlay in Partition 2 */ 
0 0 PARTITION ; /* Places it relative to Partition */ 


Figure 96. Page Overlay in an Enhanced N_UP Form Definition 


N_UP Compared to Multiple-up 


With the addition of the N_UP capability, AFP now provides two methods to format multiple application 
pages on a single sheet: 


¢ N_UP as defined in a form definition 
¢ Multiple-up as defined in a page definition 


The multiple-up function has long been available for line-format data printed on AFP printers. Multiple-up 
achieves the appearance of multiple pages on a sheet by formatting multiple groups of print lines as a 
single AFP page. The output is still a single AFP page on a side of a sheet, and the entire output is 
formatted by a single page format. If the application pages within that sheet require different print layouts, 
you must design a different page format for all possible arrangements of data. For example, if one side of 
a 2-up sheet has ten different print layouts, you need 100 different page formats to cover all the possible 
combinations. 


In contrast, N_UP enables you, for the first time in AFP, to place multiple AFP pages on a side of a sheet. 
This means that each of the N_UP pages can be formatted using a different page format. You can change 
page formats between each N_UP page without ejecting to a new side of the sheet. For the same 
example with N_UP, you need only ten page formats for a 2-up sheet with ten different print layouts. 


N_UP also means you can place multiple pages of fully-composed AFP data (or MO:DCA data) on a 


single sheet. This was not possible using the multiple-up function defined in the page definition, because 
AFP data does not use a page definition. 
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Part 3. PPFA Commands and Syntax 


Chapter 8. PPFA Command Syntax. 
Rules for Creating a PPFA Command Stream 
Token Rules . 
Character Set 
Command Delimiters. 
Blanks and Blank Lines. 
Names . 
Comments 
Literals . : 
Numeric Values. 
Units of Measurement . 
Diagram Shorthand . 


Chapter 9. Form Definition Command Reference 
Sequence of Commands for Form Definitions. 
COPYGROUP Command . 
Subcommands . 
FORMDEF Command 
Subcommands . 
OVERLAY Command 
Subcommand . . 
SETUNITS Command 
Subcommand . . 
SUBGROUP Command 
Subcommands. . . 
SUPPRESSION Command 


Chapter 10. Page Definition Command Reference (Traditional) . 


Sequence of Traditional Commands for os Definitions with PRINTLINE . 


Diagram Shorthand . . 

CONDITION Command (Traditional) . 
Subcommands . . 

DEFINE COLOR Command (raattional 
Subcommands . . 

ENDSUBPAGE Command (Traditional) . ; 

FIELD Command (Traditional) ‘ 
Subcommands. . . 

FONT Command (Traditional) 
Subcommands. . . 

OBJECT Command (Traditional) 
Subcommands. . . 

OVERLAY Command (Traditional) . 
Subcommands. . . 

PAGEDEF Command (Traditional) . 
Subcommands . . . 

PAGEFORMAT Command (Traditional) ‘ 
Subcommands . . i 

PRINTLINE Command (Traditional) 
Subcommands . . 

SEGMENT Command (Traditional) 

SETUNITS Command (Traditional) 
Subcommand . . : 

TRCREF Command (Traditional) 


© Copyright IBM Corp. 1985, 2002 


. 163 
. 163 
. 163 
. 164 
. 164 
. 164 
. 165 
. 165 
. 166 
. 166 
. 166 
. 167 


. 169 
. 169 
. 170 
. 172 
. 185 
. 186 
. 200 
. 200 
. 201 
. 201 
. 202 
. 202 
. 205 


. 207 
. 207 
. 207 
. 209 
. 209 
. 214 
. 214 
. 216 
. 217 
. 218 
. 232 
. 233 
. 235 
. 235 
. 238 
. 238 
. 239 
. 239 
. 242 
. 242 
. 244 
. 245 
. 258 
. 259 
. 259 
. 261 
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Subcommands . 


Chapter 11. Page Definition Command Reference (Record Formatting and XML) . 
Sequence of Record Formatting Commands for Page Definitions with LAYOUT . 
Sequence of Commands for XML Page Definitions with XLAYOUT. 


Diagram Shorthand . ........2.2.~. 
CONDITION Command (Record Format and XML). 
Subcommands . . oh ee eee 
DEFINE COLOR Command (Record Format and XML) . 
Subcommands . . Se Oh, oe) ie a a 
DEFINE QTAG Command (XML) . 


DRAWGRAPHIC - BOX Command (Record Format and XML) 


Subcommands . 


DRAWGRAPHIC - LINE Command (Record Format and XML) . 


Subcommands . 


DRAWGRAPHIC - CIRCLE Command (Record Format and XML) . 


Subcommands . 


DRAWGRAPHIC - ELLIPSE Command (Record Format and XML). 


Subcommands. . Se ae Bom a a 8 
ENDGRAPHIC Command (Record Format and XML). 
Subcommands. ............ 

FIELD Command (Record Format) 
Subcommands . . , 
FIELD Command (XML) 
Subcommands. . . 
FONT Command (Record Format). 
Subcommands . . a 
FONT Command (XML) 
Subcommands. ...... .. 
LAYOUT Command (Record Format). 
Subcommands. ........... 
OBJECT Command (Record Format and XML) . 
Subcommands. ........... 
OVERLAY Command (Record Format and XML) 
Subcommands. . . 
PAGEDEF Command (Record Format and XML) 
Subcommands. . . oe 
PAGEFORMAT Command (Record Format and XML) 
Subcommands. ............. 
SEGMENT Command (Record Format and XML) . 
SETUNITS Command were Format and XML) . 
Subcommand . . 5 $e eee 
XLAYOUT Command (XML) . 
Subcommands . 


Example of printing XML data with a page definition ; 
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. 261 


. 263 
. 263 
. 264 
. 264 
. 265 
. 265 
. 270 
. 270 
. 272 
. 273 
. 274 
. 276 
witt 
. 278 
. 278 
. 281 
. 282 
. 284 
. 284 
. 285 
. 286 
. 300 
. 301 
. 317 
. 318 
. 320 
. 321 
. 323 
. 324 
. 336 
. 336 
. 339 
. 339 
. 340 
. 341 
. 345 
. 346 
. 348 
. 349 
. 349 
. 351 
. 353 
. 361 


Chapter 8. PPFA Command Syntax 


PPFA controls are made up of four elements: commands, subcommands, parameters, and literals. 
* Commands are controls representing the major functions of PPFA and are separated from other 


commands by semicolons. Each command has its own entry in|Chapter 9, “Form Definition Command 

Reference” on page 169}and in|Chapter 10, “Page Definition Command Reference (Traditional)” on 
page 207 

* Subcommands fall within commands and specify the function of that command. 


¢ Parameters specify the values for one subcommand. 


, consist of fixed text included in a field definition or as constant data for comparison in a 
conditional processing definition. 


Rules for Creating a PPFA Command Stream 


When you create a PPFA command stream, follow these rules: 


¢ You cannot intermix uppercase and lowercase characters to write commands, subcommands, and 
literals. Before processing the commands, PPFA converts lowercase characters into uppercase 
characters, except those in literals. Thus, it does not discriminate between uppercase and lowercase 
characters. For example, OVERLAY abc and overlay ABC produce the same results because both 
overlay and abc are converted to uppercase. 


* Commands and subcommands can be abbreviated to the first five characters, which are always unique. 
For example, PRINTLINE can be abbreviated to PRINT, FORMDEF to FORMD, CHANNEL to CHANN, 
and so forth. 


e User names for|form definitions] and |page definitions} must not be the same as PPFA command names 


and subcommand names. These are reserved words. For a list of the reserved words, see|Appendix E, 


“PPFA Keywords” on page 433} For example, REPEAT or CHANNEL must not be form-definition 


names. 


* The subcommands governed by a command can be entered in any order; however, the name of a font 
or form definition, for example, must come immediately after the object being named. Parameters 
defined in a subcommand must be entered immediately after the subcommand. 


¢ Commands must end with a semicolon. 


¢ Acommand or subcommand can start in any column and can continue on the next line without a 
continuation indicator. 


¢ More than one form definition and page definition can be specified in a job stream. 
¢ PPFA neither checks nor sets default values for items that depend on printer hardware. 


Token Rules 


Tokens are character strings, within a set of PPFA commands, that PPFA recognizes as units. Tokens 
include: 


¢ Both local names and user-access names for fonts, form definitions, page definitions, overlays, and 
suppressions 


* Commands 

¢ Subcommands 

¢ Parameters 

¢ Literals 

¢ Special characters 


The only PPFA element that is not a token is a blank. A token cannot be split between two lines. 
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To create a token, you must separate a string from the previous token by either a special character or a 
blank. See the list of special characters in |‘Character Set”| Thus, A+B is the same as A + B, because + is 


a special character. But AB is not the same as A B. The blank in A B creates two tokens. 


Character Set 


The four types of characters are|alphabetic blank and|special} Characters of each type are as 


follows: 
* The following are PPFA alphabetic characters: 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijklmnopqrstuvwxyz 
# @ $ 


* The following are PPFA numeric characters: 


0123456789 


¢ The blank character has a character code of X'20' in ASCII (which is the data stream used for creating 
the form definition or page definition 


Note: In EBCDIC data, the blank character has a character code of X'40'. 
* The following are PPFA special characters: 
.(+*7)-%'=; /& 
¢ The following are EBCDIC shift-out and shift-in codes: 
X'0E’, the shift-out (SO) code 
X'OF', the shift-in (SI) code 


Other character codes are also allowed within comments and literals. See /‘Comments” on page 165} and 
“Literals” on page 166] for details of what can be included. 


Command Delimiters 


A command always ends with a semicolon. One command can extend over several lines and does not end 
until a semicolon appears. 


Blanks and Blank Lines 


Blanks and blank lines can occur anywhere and have no effect on the processing of PPFA. The “;” is the 
command delimiter. 
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Names 


The maximum number of alphanumeric characters in a PPFA name varies. |Table 7}shows the number of 
characters allowed in the PPFA names. 


Table 7. Character Length for PPFA Names 


Type of Name Number of Characters Allowed 
Form Definition 
COPYGROUP 1-8 
FORMDEF 1-6 
OVERLAY (local name) 1-16 
OVERLAY (user-access name) 1-6 
SUPPRESSION 1-8 
Page Definition 
BARCODE 1-8 
CONDITION 1-8 
DEFINE COLOR 1-10 
FONT (local name) 1-16 
FONT (user-access name) 1-6 
OBJECT (internal-name) 1-16 
OBJECT 1-8 
OVERLAY 1-6 
PAGEDEF 1-6 
PAGEFORMAT 1-8 
SEGMENT 1-6 


Note: The name can consist of the characters shown under the “Alphabetic Characters” and the “Numeric 
Characters” in|‘Character Set” on page 164] A local name identifies a font or an overlay only within a set of PPFA 
commands. A user-access name is the name the operating system uses to find the data. PPFA adds the appropriate 
prefix to the user-access name (for example, F1 for form definitions, P1 for page definitions, and O1 for overlays) to 
match the library resource name. 


Two PPFA commands can be used to equate the local name and the user-access name. 
OVERLAY Within a form definition 
FONT Within a page definition 


Comments 


Programmer comments used to document PPFA command streams are allowed anywhere within the 
command stream. Comments must be enclosed with the delimiters /* and «/. Acomment is allowed 
anywhere a blank is allowed and can continue for any number of lines. 


Note: For VSE, however, a comment must not start at the beginning of the line. A /* specified as the first 
two bytes of a record in PPFA running under VSE is interpreted as the end of system input. 


The following example shows the available variations in comment formats: 


FIELD /* comment */ FONT GT10 /* comment, 
multiline comment, 
more comment */ START * + 10 LENGTH 5 ; 

FIELD LENGTH 10 ; FIELD START * + 10 LENGTH 15 ; 
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Notes: 
1. Acomment must end with the closing delimiter (*/). 


2. Double-byte character codes in comments must be enclosed within SO (X'0E’) and SI (X'OF') on 
EBCDIC platforms. 


Literals 


A literal is any material specified in single quotation marks. Literals can be used within a: 
* |TEXT|subcommand to create fixed text for a page definition 
- [WHEN|subcommand to define constant text for comparison 


Literals can contain any characters in any position, except those that have special syntactic meanings. 
Single quotation marks may be used within a literal only if they are entered in pairs ('). PPFA translates a 
pair of single quotation marks into one quotation mark. For example, 'JOAN''S' yields JOAN'S. 


A literal can continue for any number of lines. For example: 


TEXT 'THIS IS ' 'A LITERAL' /* The four separated */ 
'THE TEXT SPANS' /* text elements will producex/ 
‘THREE LINES' ; /* one sequence of text */ 

TEXT X'0101' /* Hexadecimal literals */ 
X'ABAB! /* spanning three lines */ 
X'BBBB' 5 

TEXT K'100,200' /* kanji numbers */ 
K'321,400' : /* specified sequentially */ 

Invalid: 

TEXT 'THIS IS' 

K'100,200' : /* Mixing single-byte and 


double-byte characters in one 
field is not allowed */ 


A double-byte literal must be enclosed within apostrophe shift-out (X'7DOE') and shift-in apostrophe 
(X'0F7D’). 


Numeric Values 
Numeric variables are specified as decimal numbers; up to three decimal places can be specified. 


Units of Measurement 


Numbers used to specify dimensions in form definitions and page definitions can be in any of five units of 
measurement. They are specified in a command stream as follows: 


IN inches 

MM millimeters 

CM centimeters 

POINTS Points are a common measurement in printing used to measure character height, as in 
20-point type. A point is approximately 1/72 inch. 

PELS (equates to L-units) The number of pels per inch is a user-specified parameter. The default 


is 240 pels per inch. 
Two additional measurement units can be used in the SETUNITS command; the measurement units are: 
LPI lines per inch 
CPI characters per inch 


The parameters in PPFA that define a measurement can include any of the first five units of measurement 
shown in the previous list. For example: 


166 PPFA User's Guide 


POSITION 1 IN 1 IN 3 
or 
POSITION 1 MM 1 MM ; 


However, PPFA converts all measurements to logical units (L-units) as the common measurement. 
(Normally, one inch equals 240 L-units, but this number can be changed by the user.) If a fraction exists, 
the first decimal point is truncated. ASETUNITS command defines a unit of measurement that is to be 
used as the default for any parameter that does not specify a given dimension. This default is in effect 
until another SETUNITS command is encountered. This example: 


SETUNITS 1 IN 1 IN 3 


POSITION (or OFFSET or LINEONE) 1 1 ; 


shows part of a PPFA command stream in which a SETUNITS command sets the units of measurement to 
one inch for a subsequent POSITION (or OFFSET or LINEONE) subcommand. 


SETUNITS can be used as a multiplier: 
SETUNITS 2 IN 2 IN ; 


POSITION 2.2% 


In this example, the SETUNITS command sets two-inch x and y default values. The POSITION 
subcommand values are multiplied by the default values creating a position four inches horizontally and 
four inches vertically from a given reference point. See |'SETUNITS Command” on page 201] for a more 
detailed explanation. 


Diagram Shorthand 


These terms are used in the command definitions: 


x-pos_ A horizontal position using a numeric number followed optionally by a unit. For the available units, 
see|“Units of Measurement” on page 166 

y-pos Avvertical position using a numeric number followed optionally by a unit. For the available units, 
see|“Units of Measurement’ on page 166 
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Chapter 9. Form Definition Command Reference 


This section includes: 

¢ Sequence of commands for form definitions 

* Form definition commands listed alphabetically 

* Detailed information on each command 

* Descriptions of the applicable subcommands and parameters for each command 


Sequence of Commands for Form Definitions 


teal 
1. SUPPRESSION commands must be specified immediately after FORMDEF commands. The exception 
is the SETUNITS command (see item|5). 
2. One file can contain multiple sets of form definitions. 
3. OVERLAY and SUBGROUP commands must be specified under their associated COPYGROUP 
command. The OVERLAY commands must be specified immediately after a COPYGROUP command. 
* The OVERLAY command is required only to designate an overlay that is to be kept in the 3800 
printer as raster data, or to specify a local name for referencing an overlay ina SUBGROUP 
command. If you do not code the OVERLAY command, you can still specify an overlay in a 
SUBGROUP command using its user-access name. 
* Overlays also may be specified using the N_UP subcommand of the FORMDEF or COPYGROUP 
command, or using the PRINTLINE command in the page definition. If the overlay is specified in 
one of these ways, it should also not be coded on the OVERLAY or SUBGROUP commands shown 


here. For more information, see|‘Medium Overlays and Page Overlays” on page 159| 
Notes: 
a. If the form definition has only one copy group, the COPYGROUP command can be omitted. The 
OVERLAY command then follows any SUPPRESSION command. 
b. The appearance of a misplaced OVERLAY command prior to the first COPYGROUP command 
causes a default COPYGROUP to be generated as the first COPYGROUP. 


4. The first COPYGROUP command can be omitted in a form definition if it contains only one copy group 
and no OVERLAY commands. If it is omitted, the FORMDEF command parameters are used to define 
the copy group. 

5. ASETUNITS command can be placed before any PPFA command. The values set are in effect until 
the next SETUNITS command. 


Each command can appear more than once under one FORMDEF command. 


7. To do an INSERT finishing task, select a COPYGROUP that specifies the dedicated INSERT bin 
number? from which the pages are to be inserted and apply (usually dummy) print data to that page. 
Observe that nothing is printed on the inserted page. 


@ 


3. The INSERT bin number is printer specific. See the documentation for the specific printer being used. 
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COPYGROUP Command 


COPYGROUP Command 
COPYGROUP Command 
BIN—1 
>>—COPYGROUP—name 
ADJUST—n | BIN 
n MEDIANAME—@s tring: COMP ID—m. 
MANUAL. 
L_ENVELOPE— 
CUTSHEET—NO 
>. 
CONSTANT NO. CUTSHEET—YES DIRECTION ACROSS: | DUPLEX: NO. 
BACK. L_pown— NORMAL 
FRONT: TUMBLE 
_BOTH— RNORMAL. 
L_RTUMBLE— 


>-SCOPE—PAGE—OPERAT ION—ZFOLD—REFERENCE—DEFAULT 


FINISH 
SCOPE—PAGE- 
Md OPERATION—ZFOLD— OPERATION parameters | 
SCOPE: BEGCOLL Y OPERATION SADDLE | OPERATION parameters l 
L contcout— CORNER 7 
EDGE: 
FOLE: 
CUT 
L-PERFORATE— 
L_PUNCH——— 
INVOKE—SHEET: 
>. 
INVOKE NEXT. JOG a | OFFSET—rel-x - rel-y. OUTBIN—n 
[rrow_| NO. Lrel-x - ferge! 
BACK: 
>. 
L_PELSPERINCH—n PRESENT. PORTRAIT: QUALITY—n 
LL anoscape— 


_PROCESSING 


L-MEDIA_INFO.: | n 


L-PERFORATE 


CUT. 


>< 


BwWNrH 


OVERLAY Subcommand 
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PLACE Subcommand —e 


e 


COPYGROUP Command 


OPERATION Parameters: 


>-REFERENCE—DEFAULT: 
‘OPERATION zi 
'_REFERENCE TOP. OPCOUNT—n OPOFFSET—n 


BOTTOM OPPOS—n 
LEFT. 
RIGHT 
TOPLEFT- 
I-TOPRIGHT— 
—BOTLEFT— 
_BOTRIGHT— 


OVERLAY Subcommand: 


r-OVROTATE—O 
OVERLAY—name | | al | | 
X-pOS—y-pos PARTITION '_OVROTATE 90 
180: 
270 


PLACE Subcommand: 


(1) FRONT— 
| PLACE n H | I > 
BACK—___ CONSTANT: OFFSET—rel-x—rel-y. | Overlay Subcommand a 
--ROTATION—O VIEW—YES 
> | 
| 
'_ROTATION 90. VIEW—NO: 
180 
—270— 
Notes: 


1 


The use of the PLACE subcommand indicates enhanced N_UP printing. 


Copy groups are subsets of a form definition. A form definition can contain one or several copy groups. 
Copy groups are nested within a form definition following any SUPPRESSION command. COPYGROUP 
subcommands have no fixed defaults; if any subcommand is omitted, its value is selected from the 
corresponding subcommand in the FORMDEF command. 


Notes: 


1. 
2: 


Subsets of copy groups are called subgroups. 


If you specified DUPLEX NO anywhere in the copy group, output is simplex regardless of any other 
DUPLEX subcommand within the same copy group. 

If a form definition has only one copy group, the COPYGROUP command can be omitted. If omitted, a 
name is automatically assigned by PPFA to the copy group, using the form definition resource name, 
including the F1 prefix. All values for the copy group are given the values from the FORMDEF 
command and subcommands. You need to know this name should you use conditional processing and 
need to invoke this copy group by name. Copy groups are placed within the form definition in the order 
in which they are generated. 

To change copy groups during formatting, use conditional processing. 

Another way to change copy groups after the resource is stored is to insert an|Invoke Medium Map 
structured field into your print data file (copy groups are known to the print server as medium maps). If 
no Invoke Medium Map structured field is found and no conditional processing is being performed, the 
first copy group in the form definition is used for the job. 
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COPYGROUP name 
Defines an alphanumeric name of 1-8 characters. This name must be unique in a single 
form definition. If any names are duplicated, PPFA issues an error message and does not 
create the form definition. 


Subcommands 


ADJUST n 


BIN 


Establishes the range of horizontal adjustment for the print area on the sheet. 


n The adjustment range can be set from 0 to 20 L-units. After a value is set, it is the 
maximum amount available in both directions, plus and minus.* 


Note: If you specify ADJUST, the maximum logical page size (in the horizontal 
direction) is reduced by the amount you specified here. 


Specifies the paper source. This subcommand should be used only for printers that have 
more than one paper source. 


1 
2-255 


MANUAL 


ENVELOPE 


MEDIANAME 


COMPID 


Selects the primary paper source. 


Selects another paper source. If the specified bin does not exist on your 
printer, the default paper source for that printer is used. For more 
information about paper sources on your printer, refer to your printer 
publications. 


Selects manual feed as a paper source on those printers that support 
manual feed. For more information, refer to your printer publications. 


Selects an envelope paper source on those printers that support this 
function. For more information, refer to your printer publications. 


Selects a media source by specifying an agreed-upon name for the bin. 


gstring Up to 12 characters within single quotes, specifying the media 
source name. On some printers, this name is pre-set into the 
printer; on other printers, it can also be entered into the printer by 
the user. For a current list of the valid media names, see 
Refer to your 
printer publications for further information. 


Notes: 


1. BIN selection is overridden by the printer if the form defined to 
each bin is the same form number. Only the primary bin is 
selected. 


2. The primary source usually contains either letter-size (U.S.) or 
A4 (I.S.0.) paper. Other paper sources are used for less 
common paper sizes (such as legal-size) and for special paper 
(such as colored stock or pre-printed letterhead on heavy 
bond). 

3. If duplexing is requested and you select from the front side 
from one bin and the back side from another bin, a warning 
message is issued and the printer takes the paper from the bin 
specified on the front side. 


Selects a bin based on the component id. 


4. The ADJUST rn subcommand used only on the IBM 3800 printers. 
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CONSTANT 


CUTSHEET 


DIRECTION 


COPYGROUP Command 


m For acurrent list of component ids, see|Appendix F, “PPFA Media 


Names” on page 435} Component ids from 12,288 to 268,435,455 are 
reserved for the user. 


Specifies whether the constant-forms function is on or off and whether constant form is to 
be printed on the front or back sides of a sheet. 


NO Specifies that the constant forms function is off. 


BACK Specifies that a constant form is to be printed on the back side without 
variable data. 


FRONT Specifies that a constant form is to be printed on the front side without 
variable data. 


BOTH Specifies that a constant form is to be printed on both sides without 
variable data. 


If you are using a cut-sheet printer, this subcommand specifies whether the medium 
orientation information, using the DIRECTION and/or PRESENT subcommands, is to be 
passed to the printer. The default value is NO. 


YES _ Specifies the rotation data is to be passed. 
NO Specifies the rotation data is not to be passed unless N_UP is coded. 


Notes: 

1. If you have a continuous form printer, the medium orientation information is passed. If 
you have a cut-sheet printer and N_UP is coded, the orientation information is passed. 

2. If you have a cut-sheet printer and CUTSHEET YES is coded, the orientation 
information is passed, providing you also have a level of the print server that supports 
that feature. 


3. You must have a printer that allows its media origin to be changed in order to use this 
subcommand. 


Example: 


In the following example, the CUTSHEET subcommand is coded on the form definition to 
give copygroups c1 and c2 “CUTSHEET YES” behavior and copygroup c3 “CUTSHEET 
NO” behavior. The copygroup c1 inherits its behavior from the form definition. 
FORMDEF cutl REPLACE YES CUTSHEET YES; 

COPYGROUP cl ; 

COPYGROUP c2 CUTSHEET YES ; 

COPYGROUP c3 CUTSHEET NO ; 


Determines, along with the PRESENT subcommand, how data is oriented on printers 
whose media origin can be changed. See the list of printers}Chapter 7, “N_UP Printing” on 


If you are printing line data, you usually specify the same value for the DIRECTION 
subcommand as is specified for the DIRECTION subcommand in the page definition. 


ACROSS Specifies that the pages are formatted in the ACROSS printing direction. 
DOWN Specifies that the pages are formatted in the DOWN printing direction. 
If the DIRECTION subcommand is specified, you must specify the PRESENT 


subcommand. The default for DIRECTION is determined by the value specified for 
PRESENT. 
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The direction default of PORTRAIT is ACROSS; the direction default of LANDSCAPE is 
DOWN. If neither PRESENT nor DIRECTION is specified, the default is PRESENT 
PORTRAIT and DIRECTION ACROSS. 


DUPLEX Specifies whether printing is done on both sides of the sheet. This subcommand should be 


used only for page printers that have duplex capability. 
NO Duplex printing is not performed. 


NORMAL Duplex printing is performed, with the tops of both sides printed along the 
same edge for side binding. 


TUMBLE Duplex printing is performed with the top of one side and the bottom of the 
other printed along the same edge of the sheet for top binding. 


RNORMAL Rotated normal. Duplex printing is performed with the tops of both sides 
printed along the same edge. Used with landscape pages, N_UP 2, and 
N_UP 3. 


RTUMBLE Rotated tumble. Duplex printing is performed with the top of one side 
printed along the same edge of the sheet as the bottom of the other. Used 
with landscape pages, N_UP 2, and N_UP 3. 


FINISH A finishing operation is to be performed on this COPYGROUP. This option is to be used 
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only on a document, set of documents, or an entire print file. 


SCOPE Determines how the finishing operation is applied. 


Note: SCOPE can be repeated within a FINISH subcommand, but only 
one SCOPE of a particular type is allowed in each COPYGROUP 
command. For example, only one SCOPE BEGCOLL is allowed in 
a COPYGROUP command. 


PAGE (or MEDIUM) 
Medium-map level, each medium or sheet. The specified 
finishing operation is applied to each sheet individually. 
ZFOLD is the only operation valid for this SCOPE 
command. 


Collection Scope 
Medium-map level, collection of media or sheets. All 
sheets generated by this medium map are collected and 
the specified finishing operations are applied to this 
collection. 


Note: Some finishing operation combinations are not 
compatible. Compatible combinations are 
dependent upon the presentation-device. 


BEGCOLL Begin medium-map level collections. This causes a sheet 
eject and starts a medium-map-level media collection for 
the specified operation. If a collection for the same 
finishing operation is already in progress from a previous 
medium map, that collection is ended and its specified 
finishing operation is applied. The media collection started 
with BEGCOLL continues until: 

1. The end of the document is reached. 
2. Amedium map is invoked that is not CONTINUE 
COLLECTION for this same OPERATION command. 


When a finishing collection is ended for any of the above 
reasons, the specified finishing operation is applied. 
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CONTCOLL 


OPERATION 


COPYGROUP Command 


Continue medium-map level collection. This continues a 

medium-level media collection that was started for the 

same finishing operation by a previous medium map. The 

media collection started with CONTCOLL continues until: 

1. The end of the document is reached. 

2. Amedium map is invoked that is not CONTINUE 
COLLECTION for this same OPERATION command. 


When a finishing collection is ended for any of the above 
reasons, the specified finishing operation is applied. 


OPERATION specifies the FINISH operation type. 


Note: The default for OPERATION is ZFOLD. It is 
necessary to code OPERATION only if 
REFERENCE is coded. 


ZFOLD Perform a ZFOLD operation along the 
finishing edge (axis). Z-Folding causes the 
sheet to first be folded in half inwards (the 
front side of the sheet is now inside the 
fold) along a line parallel to the reference 
edge. The half of the sheet originally 
furthest from the reference edge is again 
folded in half outwards along a line 
parallel to the reference edge. For 
example, when Z-Folding is applied to an 
11 by 17 inch sheet with the reference 
edge along a short side, the result is an 
8.5 by 11 inch fold-out. 


SADDLE Specifies that one or more staples are 
driven into the media along the axis of the 
finishing operation, which is positioned at 
the center of the media, parallel to the 
reference edge (see REFERENCE 
parameter). 


CORNER Specifies that one staple is driven into the 


media at the reference corner (see 
REFERENCE parameter). For corner 
staples, the offset and angle of the staple 
from the selected corner is device 
dependent. 


EDGE Specifies that one or more staples are 
driven into the media along the axis of the 
finishing operation. 

FOLD Specifies that the media is folded along 
the axis of the finishing operation. 


CUT Specifies that a separation cut is applied 
to the media along the axis of the finishing 
operation. 


PERFORATE Specifies that a perforation cut is applied 
to the media along the axis of the finishing 
operation. 


PUNCH Specifies that one or more holes are to be 
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punched or drilled into the media along 
the finishing axis. PUNCH is applied to he 
collected media, not to individual media. 


REFERENCE Selects the reference edge or corner for the finishing 
operation. The REFERENCE subcommand is optional 
and, when omitted, the DEFAULT attribute is the default. 


DEFAULT 


TOPLEFT 


TOPRIGHT 


BOTRIGHT 


BOTLEFT 


TOP 
BOTTOM 
RIGHT 
LEFT 


OPCOUNT rn! OPPOS n 


Specifies that the device default edge 
determines the reference edge. 


Specifies that the reference corner is 
positioned at the top in the left corner. 
This REFERENCE parameter can be used 
only for CORNER operations. 


Specifies that the reference corner is 
positioned at the top in the right corner. 
This REFERENCE parameter can be used 
only for CORNER operations. 


Specifies that the reference corner is 
positioned at the bottom in the right 
corner. This REFERENCE parameter can 
be used only for CORNER operations. 


Specifies that the reference corner is 
positioned at the bottom in the left corner. 
This REFERENCE parameter can be used 
only for CORNER operations. 


Specifies that the reference is positioned 
along the top edge. 


Specifies that the reference edge is 
positioned along the bottom edge. 


Specifies that the reference edge is 
positioned along the right edge. 


Specifies that the reference edge is 
positioned along the left edge. 


Specify either the number of finishing operations 
requested (see OPCOUNT), or the positions for each 
operation on the axis of the finishing operation (see 


OPPOS). 
OPCOUNT 


OPPOS 


Use OPCOUNT to request a specific 
number of finishing operations; valid 
values are 1-122. Do not specify OPPOS 
values with OPCOUNT. If OPPOS is 
specified for corner staple, separation cut, 
perforation cut or fold, this OPCOUNT 
value is ignored. The printer determines 
the positions of the operations. The 
default is 0 (zero). 


Use OPPOS io control the position of 
each operation on the axis of the finishing 
operation. The subparameter is an integer 
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value in the range of 0-32,767, 
representing millimeters. Do not specify 
the unit of measure. Do not specify 
OPCOUNT when you use OPPOS. If 
OPPOS is specified for corner staple, fold, 
separation cut, or perforation cut, the 
OPCOUNT value is ignored. 


OPOFFSET 1 Specifies that the axis for the finishing operation is offset. 
The subparameter is an integer value in the range of 
0-32,767, representing millimeters. Do not specify 
OPOFFSET for corner staple or saddle stitch; the corner 
staple or saddle stitch values are ignored when specified 
with OPOFFSET. 


The following examples show how to specify finishing 
operations. 


To request scope as the entire print job with one corner 
staple in the top left corner, specify: 


FINISH SCOPE PRINTFILE OPERATION CORNER REFERENCE TOPLEFT; 


Notes: 


1. 


Your printer must have the appropriate finishing hardware to perform finishing 
operations. 


The default OPERATION is ZFOLD, and the default REFERENCE is DEFAULT. 


Your print server may have a limit on the number of collection operations that can be 
open at one time. 


For the finishing operation, changing the orientation of the medium presentation space 
does not change the finishing position. For instance the finishing reference edge 
(corner) is not affected by DIRECTION or PRESENT values. 

If more than one finishing operation is specified, the operations are applied in the order 
in which they are specified. Identical finishing operations for the same SCOPE are not 
supported. 


The following are examples of finishing operations: 


1. 


2. 


ZFOLD pages (for which the xyz COPYGROUP is in effect), specifying the left edge of 
the document as the reference edge: 


COPYGROUP xyz 
FINISH OPERATION ZFOLD REFERENCE LEFT 


Three examples of ZFOLD pages that specify the default edge of the document: 
COPYGROUP xyz FINISH; 


or 
COPYGROUP xyz FINISH OPERATION ZFOLD; 


or 
COPYGROUP xyz FINISH OPERATION ZFOLD REFERENCE DEFAULT; 

An example of a COPYGROUP finishing command where COPYGROUP 1 begins the 
finishing collection for corner stapling, folding, and separation cut. COPYGROUP 2 
continues the fold, cut, and corner operations and stops all other operations. 
COPYGROUP 3 continues any corner stapling, begins a new punch and fold group, 
and stops all other operations. 
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INVOKE 


COPYGROUP 1 
FINISH 
SCOPE BEGCOLL OPERATION corner REFERENCE topleft 
OPERATION fold 
OPERATION cut; 


COPYGROUP 2 
FINISH 
SCOPE CONTCOLL OPERATION fold 
OPERATION cut 
OPERATION corner; 


COPYGROUP 3 
FINISH 
SCOPE CONTCOLL OPERATION corner REFERENCE topleft 
SCOPE BEGCALL OPERATION punch 
OPERATION fold; 


Finishing Operation Nesting Rules: 
When more than one finishing operation involving a collection of media is specified 
for some portion of the print file, a nesting of the operations is defined first by the 
scope of the operation and second by the order of the operation in the data 
stream. 


Finishing operations with a broader scope are nested outside of finishing 
operations with a narrower scope. The following scopes are listed in descending 
order: 

1. Print-file level finishing (SCOPE PRINTFILE) 

2. Document-level finishing, each document in the print file (SCOPE ALL) 

3. Document-level finishing, a selected document in the PRINTFILE (SCOPE n) 
4. Medium-map-level finishing, a collection of sheets (SCOPE BEGCOLL) 


Finishing Operation Implementation Notes: 


1. AFP environments limit the number of finishing operations that can be nested 
at the medium map (COPYGROUP) level to sixteen. 

2. In AFP environments, the nesting of identical finishing operations at the 
medium-map-level is not supported. Two finishing operations are identical if the 
OPERATION, REFERENCE, OPCOUNT or OPPOS, and OPOFFSET are the 
same. 


Specifies where the next page of data is placed when this copy group is activated by 
conditional processing or by an Invoke Medium Map structured field. 


INVOKE SHEET, which is the default, places the next page of data on a new sheet. The 
NEXT, FRONT, and BACK parameters place the next page in a subsequent partition on 
the same sheet or, if no partitions are available, on the next sheet. If FRONT or BACK is 
specified, INVOKE selects only partitions on the front or back, respectively. 


The print server honors the NEXT, FRONT, and BACK values of the INVOKE 
subcommand only if the new copy group has the same medium modifications as the 
previous copy group. Medium modifications include duplexing, bin, page offset, N_UP 
values, presentation, direction, and medium overlays. 


If any of these modifications differ, the print server ejects to a new sheet when the copy 
group is invoked. If you want to change overlays when ejecting to a new partition, use 
page overlays instead of medium overlays. See Medium Overlays and Page Overlays’ Or 
page 159|for information about page and medium overlays. 


When you use PLACE subcommanads, the NEXT, FRONT, and BACK parameters place 
the next page using the next sequential PLACE subcommand that matches the 
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requirement (next, front, or back). For example, if you print using the second PLACE 
subcommand of copy group A, and then you change to copy group B, you start with the 
third PLACE subcommand of copy group B. 


A CONSTANT parameter on the PLACE subcommand does not alter the selection 
process. The selection is complete, even though the selected PLACE subcommand does 
not place the data. N_UP performs the constant modification and continues until it finds a 
PLACE subcommand that does not specify CONSTANT. The data is placed with this 
subcommand. Observe that this PLACE subcommand need not match the FRONT or 
BACK specifications of the INVOKE subcommand. 


SHEET Specifies that data be placed in the first selected partition of the sheet. 
NEXT Specifies that data be placed in the next selected partition. 

FRONT Specifies that data be placed in the next selected front partition. 
BACK Specifies that data be placed in the next selected back partition. 


Specifies whether a JOG subcommand is sent to the printer when this COPYGROUP is 
selected by an IMM structured field, or through conditional processing. When the JOG 
subcommand is sent, a printer either offsets (jogs) or prints copymarks. For cut-sheet 
printers, or for continuous-forms printers with burster-trimmer-stacker enabled, the JOG 
subcommand causes the first sheet controlled by this COPYGROUP to be stacked offset 
from the previous sheets. For continuous forms printers without a burster-trimmer-stacker, 
the JOG subcommand causes an increment in the copymark printed on the carrier strip. 
JOG subcommands also are sent to the printer at the beginning of each data set or at the 
beginning of each job, depending on host parameters. For more information about 
copymarks, see the system programming guide for your host print server. 


YES __ Specifies that a JOG subcommand be sent to the printer. The first sheet printed is 
offset or the copymark is incriminated. 


NO Specifies that no JOG subcommand be sent to the printer. The first sheet printed 
is not offset; the copymark is not incriminated. 


Specifies the relative offset of the logical page for both the front and back pages in 
reference to the media origin. The media origin is printer dependent. For more information 
about media origin, see your printer publications or /BM Printing Systems: Printer 
Information. 


If you specify offset values for the back of the page, you must also specify the front offset 
values. 
Note: The OFFSET subcommand does not affect the position of medium overlays. 


rel-x Specifies the relative horizontal offset of the logical page on the front or back side 
of the copy group relative to the media origin. The valid options for rel-x are 
described in the SETUNITS command for the horizontal value. 


If no unit is specified, a default setting is: 
* Taken from the last SETUNITS command 
¢ IN (inch) if no SETUNITS command has been issued 


rel-y Specifies the relative vertical offset for the logical page for the front or back side of 
the page. The valid options for re/-y are described in the SETUNITS command for 
the vertical value. 
Note: The vertical offset for the 3800 must be 0.5 inch or greater. 


If no unit is specified, a default setting is: 


¢ Taken from the last}SETUNITS|command 
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OUTBIN n 


* IN (inch) if no SETUNITS command has been issued 


Notes: 

1. If OFFSET is not specified, the OFFSET default is 0.1 IN 0.1 IN 

2. You may specify this offset as negative in order to crop the top and/or left of 
an image. 


Specifies the destination bin number for any pages directed by this COPYGROUP. 
Subgroups in this form definition that do not specify an output bin number inherit this one. 


n_ the output bin number 


PELSPERINCH n 


PRESENT 


QUALITY n 


Specifies the Logical Units in pels per inch for this COPYGROUP. Use the 
PELSPERINCH parameter to tell PPFA the pel resolution of your printer to generate more 
exact object placements. 


n Specifies an integer number between 1 and 3,276, which determines the Logical Units 
in pels per inch. 


Note: If the L-Units are not specified on the copy group, they are inherited from the 
form definition. See|Figure 98 on page 195]for more information. 
Specifies, along with the DIRECTION subcommand, how the data is oriented on printers 
whose media origin can be changed. 


The PRESENT and DIRECTION subcommands are only supported by cut-sheet printers 
when you specify the IN_UP}]subcommand or the CUTSHEET subcommand with the YES 
parameter. See [Figure 73 on page 142|through|Figure 76 on page 145]to determine the 
effect of the PRESENT and DIRECTION subcommands when you use them with the 
N_UP subcommand. 


PORTRAIT Specifies that the pages are printed in the portrait page presentation, with 
their short edges at the top and bottom and their long edges at the sides. 


LANDSCAPE Specifies that the pages are printed in the landscape page presentation, 
with their long edges at the top and bottom and their short edges at the 
sides. 


Specifies the print quality. This subcommand is recognized only on printers that can 
produce more than one level of print quality. The default is determined by the printer 
model. (On some printers, the default may be set at the printer itself.) For more 
information, refer to your printer publications. 


n_ You can select a level of print quality by entering any whole number from 1 to 10. 
Higher numbers correspond to higher levels of print quality; lower numbers 
correspond to lower levels. For more information, refer to your printer publications. 


Print quality is determined by a numerical code in the range of 1 to 254 (hexadecimal 
X'01'-X'FE'). The codes corresponding to the possible QUALITY parameters are: 


1 = 15 (X'0F') 
2 = 40 (X'28) 
3 = 65 (X'41') 
4 = 90 (X'5A’) 
5 = 115 (X'73') 
6 = 140 (X'8C') 
7 = 165 (X'A5') 
8 = 190 (X'BE’) 
9 = 215 (X'D7’) 


10 = 240 (X'FO’) 
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PROCESSING 
Specifies additional post processing capabilities for selected printers and attached 
equipment. This option can only be used on a single sheet or collection of sheets. This 
subcommand expects 1 to 3 of the following keywords: 


MEDIA_INFO n 
This parameter specifies the ID of fixed medium information that a printer 
or printer—attached device applies to a sheet. Examples include color 
plates logos, letter heads, and other fixed images. 


The numeric values that can be included are: 


0-254 These numeric values select a particular fixed medium local ID 
that the printer or printer—-attached device applies to a sheet. One 
or more IDs can be specified within this range. 


255 This value selects all the current fixed medium local IDs that the 
printer or printer—attached devices applies to a sheet. 


PERFORATE Specifies a perforation cut at one or more fixed locations on the sheet 
according to the printer or printer—attached device. 


CUT Specifies a separation cut at one or more fixed locations on the sheet 
according to the printer or printer—attached device. 


N_UP {1121314} 
Specifies the number (1, 2, 3, or 4) of equal-size partitions into which the sheet is divided. 


See thelist of printers] that support the N_UP subcommand. 


If you do not specify the N_UP subcommand in the COPYGROUP command, the N_UP 
subcommand from the FORMDEF command is the default for the COPYGROUP 
command. You can mix N_UP printing and non-N_UP printing by specifying or not 
specifying the N_UP subcommand in each copy group and by not specifying N_UP in the 
FORMDEF command. 


OVERLAY name 
Specifies the user access name (up to six characters) of an overlay to be 
placed with every page in each of the N_UP partitions. You can specify a 
maximum of 254 OVERLAY subcommands in a copy group. 


Notes: 


1. The prefix ‘O1’ is not part of the six-character user-access name. The 
overlay name can be an alphanumeric. 


2. This name is not related to names as defined on the OVERLAY 
command. 


X-POS y-pOs Specifies the horizontal and vertical adjustment to the 
position of the overlay. This is in addition to any offset 
values built into the overlay. The x and y values must be 
positive (+). You can specify them in inches (IN), 
millimeters (MM), centimeters (CM), POINTS, or PELS. If 
you do not specify a unit value, PPFA uses the unit value 
specified in the last SETUNITS command or uses a 
default unit value of inches. 


Note: This OVERLAY subcommand cannot be specified if 
the PLACE subcommand is specified. 


PARTITION Specifies that the overlay is to be placed relative to the 
partition origin. 
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Specifies the rotation of the placed overlay with respect to 
the x-axis of the page. 


Example: Assuming the overlay has ( 0,0 ) 
placement coordinates, this causes page 
overlay “O1x2” to be placed 1.5 inches to 
the right and 2.7 inches below the 
beginning of the page and rotated 90 
degrees clockwise with respect to the 
page. 

Formdef xmpl 
NUP 1 PLACE 1 FRONT 


OVERLAY x2 1.5 in 2.7 in 
OVROTATE 90; 


PLACE Places a page of data or a constant modification relative to a partition. 
Each PLACE subcommand specifies the number n of a partition on either 
the front or back side of the sheet. FRONT is the default, if you do not 
specify this subcommand. You must specify the same number of PLACE 
subcommands as the number of partitions on the sheet. The sequence of 
the PLACE subcommands is the sequence in which incoming pages are 
placed in the partitions. 


Note: The PLACE subcommand is valid only on printers that support 
enhanced N_UP printing. If PLACE is not specified, pages are 
placed in partitions in the default partition sequence. 


FRONT 


BACK 


CONSTANT 


OFFSET 
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Specifies the numbered partition (1-4) into which the page 
of data is placed. See|Figure 73 on page 142|through 

for the locale of each numbered 
partition. 


Specifies that this partition be placed on the front side of 
the sheet. 


Specifies that this partition be placed on the back side of 
the sheet. 


Specifies that no page data is placed by this PLACE 
subcommand. 


Use CONSTANT when you are placing overlays without 
user’s data or are placing fewer data pages on the sheet 
than the number of partitions specified in the N_UP 
subcommand. 


For an example of using the CONSTANT parameter with 


overlays and to understand how the ordering_of the 
PLACE subcommand affects overlays, see 
N_UP Example 3: Asymmetric Pages” on page 157 


Specifies a relative offset of the page horizontally (x) and 
vertically (y) from the partition origin. 


rel-x rel-y The default value is 0.1 inch for both x 
and y offsets. This OFFSET parameter 
overrides any other OFFSET parameters 
specified on the FORMDEF or 
COPYGROUP command. You can specify 
the units in inches (in), millimeters (mm), 
centimeters (cm), points, or pels. If you do 


OVERLAY name 
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not specify a unit value, PPFA uses the 
unit value specified in the last SETUNITS 
command or uses a default unit value of 
inches. 


Note: You may specify this offset as 
negative in order to crop the top 
and/or left of an image. 


Specifies the user access name (up to six characters) of 
an overlay to be placed with this PLACE subcommand. 
The overlay is placed relative to the page origin or, if the 
PARTITION keyword is specified, to the partition origin. 
You can specify multiple OVERLAY parameters in each 
PLACE subcommand. 


Note: This OVERLAY subcommand cannot be specified if 
the PLACE subcommand is specified. 


X-POSs y-pos 


PARTITION 


Specifies the horizontal and vertical 
adjustment to the position of the overlay. 
This is in addition to any offset values built 
into the overlay. The x and y values must 
be positive (+). You can specify them in 
inches (in), millimeters (mm), centimeters 
(cm), points, or pels. If you do not specify 
a unit value, PPFA uses the unit value 


specified in the last}|SETUNITS} command 


or uses a default value of inches. 


Specifies that the previous offset is from 
the partition origin. If not present, the 
offset is from the page origin, which is 
subject to the OFFSET parameter. 


OVROTATE {01 901 180 | 270 } 


~ Specifies the rotation of the placed overlay 


with respect to the x-axis of the page. 


ROTATION { 0 | 90 | 180 | 270 } 
Specifies the clockwise rotation of the page and 
associated page overlays placed by this PLACE 


command. 


Rotation turns the page and its associated page overlays 
around their fixed origin points. If you rotate the page 

without moving its origin point, you might rotate it off the 
physical medium. To prevent this, always offset the page 


origin to the 


as shown in 


place you want it to be for the rotated page, 
Figure 97 on page 184 
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1 Inch 


T — rf 9 inch 


i 
0° 90° 


Page offset 1 in., 1 in. Page offset 9 in., 1 in. 


1 Inch 
1 Inch 
ebed 


> Page origin 
e Partition origin 


Figure 97. Offsetting the Page Origin for Rotated Pages 


VIEW Determines if this N_UP PLACE page is viewable. VIEW 
is relevant only when the page is being presented on a 
display. VIEW is ignored if the page is being printed. If 
VIEW is not coded, it is equivalent to specifying VIEW 


YES. 

YES ___ Specifies that this N_UP page is viewable and is 
presented. 

NO Specifies that this N_UP page is not to be 
presented. 
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FORMDEF Command 
BIN—1 
>>—FORMDEF—name: 
ADJUST—n BIN | 
n MEDIANAME—qs tring COMP ID—m. 
MANUAL 
L_ENVELOPE 
>. 
BINERROR STOP. COLORVALUERR—STOP. 
Lcontrnue— pene) 
--COLORVALUERR—CONT INUE- COMMENT: qstring 
L_ REPORT! 
-—-CUTSHEET—NO— 
>. 
CONSTANT NO. CUTSHEET—YES— ‘DIRECTION ACROSS: DUPLEX: NO. 
BACK: Lown NORMAL—4 
FRONT: TUMBLE—+ 
-BOTH— RNORMAL+ 
RTUMBLE— 
FONTFID—NO. 


--SCOPE—PRINTFILE— 


“FONTFID—YES— 


>< 


FINISH | FINISH Operation Parameters 
SCOPE: ALL, 
Ln 
INVOKE—SHEET: 
>. 
INVOKE NEXT. JOG YES: | OFFSET—rel-x - rel-y: TJ OUTBIN—n 
FRONT. L no] Lrel-x - rel-y 
BACK 
REPLACE—NO 
>. 
L_PELSPERINCH nr] PRESENT: PORTRAIT. | QUALITY a) REPLACE—YES 
Li anoscape— 
>. 
N_UP. 1 
| 2 
|_PROCESSING 3 
4 Y_4 QVERLAY Subcommand 
I-MEDIA_INFO—*—n 
L-PERFORATE 4 PLACE Subcommand - 
CUT 
-—-TONERSAVER—DEVSETTING— 
> 3 
_TONERSAVER OFF 
el Lon 
LVFYSETUP—* veri ficationID. 


FINISH Operation Parameters: 
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I I} 
| —OPERATION—CORNER sl 
L_OPERATION——-—SADDLE REFERENCE——TOPLEFT. OPCOUNT—n OPOFFSET—n_] 
LEDGE TOPRIGHT. OPPOS—n 
L-FOLD BOTRIGHT— 
L-CUT. BOTLEFT— 
|_PERFORATE TOP. 
“PUNCH BOTTOM 
LEFT 
RIGHT—— 
OVERLAY Subcommand: 
—OVROTATE—O 


[-—OVERLAY—name 7 7 | 
_x-pos - y-pos ‘PARTITION '_OVROTATE 90 

180 
—270— 


PLACE Subcommand: 


(1) FRONT 
|—PLACE n 
BACK. CONSTANT: OFFSET—rel-x—rel-y OVERLAY Subcommand 


—-ROTATION—O VIEW— YES 
> | 
__ROTATION 90 VIEW—NO 
180 
L270 
Notes: 


1 The use of the PLACE subcommand indicates enhanced N_UP printing. 


A form definition is a resource that contains all the controls relating to the physical sheet. A FORMDEF 
command must be specified when you define a new form definition. When subcommands (except for the 
REPLACE, PRESENT, and DIRECTION subcommands) are specified, they become the defaults for all 
COPYGROUP commands nested within this form definition. 


FORMDEF Identifies the form definition to be used with the print job. 


name Defines an alphanumeric name of 1-8 characters for the form definition. When you create 
a form definition, PPFA assigns a prefix of F1 to the name you specify. Finnnnnn is the 
external resource name in the form-definition library. 


Subcommands 


ADJUST n Establishes the range of horizontal adjustment for the printed area on the sheet. The 
default is 0 The adjustment range can be set from 0 to 20 L-units. After a value is set, it is 
the maximum amount available in both directions, plus and minus. 

Notes: 


1. If you specify ADJUST, the maximum logical page size (in the horizontal direction) is 
reduced by the amount you specified here. 


2. The ADJUST nsubcommand is used only on the IBM 3800 printers. 
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Specifies which paper source is to be used on printers with more than one paper source. 
The value range is 1-255. (This subcommand should be used only for printers that have 
more than one paper source.) 


Note: If you specify the BIN subcommand, you must also specify at least one of the legal 


parameters. 
n An integer number between 1 and 255 that is the Media Source Id (also 
known as the bin number). 
1 Selects the primary paper source. 
2-255 Selects another paper source. If the specified bin does not exist on your 


printer, the default paper source for that printer is used. For more 
information about paper sources on your printer, refer to your printer 
publications. Using a value of 100 is the same as specifying MANUAL. 


MANUAL Selects manual feed as a paper source on those printers that support 
manual feed. For more information, refer to your printer publications. 


ENVELOPE _ Selects an envelope paper source on those printers that support this 
function. For more information, refer to your printer documentation. 


MEDIANAME Selects a media source by specifying an_agreed upon name for the bin. 
For a list of the valid media names, see|Appendix F, “PPFA Media Names” 
on page 435 
qstring Up to 12 characters within single quotes specifying the media 
source name. On some printers, this name is pre-set into the 


printer; on others, it also can be entered into the printer by the 
user. Refer to your printer documentation for further information. 


COMPID m Selects a bin based on the component id. 


Note: For a current list of component ids, see|Appendix F, “PPFA Media 


Names” on page 435| Component ids from 12,288 to 268,435,455 
are reserved for the user. 


Notes: 


1. BIN selection is overridden by the printer if the form defined to each bin is the same 
form number. Only the primary bin is selected. 


2. The primary source usually contains either letter-size (U.S.) or A4 (I.S.O.) paper. Other 
paper sources are used for less common paper sizes (such as legal-size) and for 
special paper (such as colored stock or pre-printed letterhead on heavy bond). 

3. If duplexing is requested and you select from the front side from one bin and the back 
side from another bin, a warning message is issued and the printer takes the paper 
from the bin specified on the front side. 


Tells the printer whether or not you wish to stop printing if the wrong media is loaded on 
the printer. 


This subcommand is displayed only on the FORMDEF command, not the COPYGROUP 
or the SUBGROUP commands since the scope of the subcommand is throughout the 
FORMDEF. Printing control is based on the status of the media loaded as it pertains to 
the BIN subcommand in effect at the time. 


STOP If the specified input bin cannot be found, stop the print job and hold it in a 
state from which it can be resubmitted. 


CONTINUE If the specified input bin cannot be found, continue printing using the 
printer default input bin. 
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COLORVALUERR 
When the form definition contains color values that the printer cannot render exactly as 
specified, you may request that the printer substitute colors and continue job processing, 
or you may request the printer to stop. If you request STOP, the printer issues an error 
and terminates. If you request CONTINUE, you may ask for an error report. 


STOP Specifies that an error should be issued by the printer and the job 
terminated if the printer reports a color exception. A color exception is 
reported if the color specification in the data stream cannot be rendered 
as specified. Also, a color exception is reported if the host print server 
supports color fidelity and the target printer does not. 


CONTINUE Specifies that an exception condition should be ignored. Also, the printer 
substitutes colors for any that it cannot render, and the job continues. 


REPORT Specifies that the error should be reported by the printer. 


NOREPORT _ Specifies that the error should not be reported by the 
printer. NOREPORT is the default if COLORVALUERR 
CONTINUE is coded and neither REPORT nor 
NOREPORT is coded. 


Note: When the printer reports a color value exception, the following actions are taken: 


¢ If the print server and the printer both support Color Fidelity and the 
COLORVALUERR subcommand is coded, printing occurs as previously 
described. 


¢ If the print server and the printer both support Color Fidelity and the 
COLORVALUERR subcommand is not coded, the print server instructs the 
printer to reset to defaults at the beginning of the job. 


* Whenever the print server supports Color Fidelity, but the printer does not, the 
following rules apply: 


— If no COLORVALUERR subcommand is issued, printing continues. However, 
color exception errors are reported and ignored. 


— If the COLORVALUERR subcommand is issued, you could receive print 
server errors or the command could be ignored, depending on the level of 
PSF you have installed and your platform (for example, OS/390, VM, AIX, and 
so on). Therefore, you should not use the COLORVALUERR subcommand if 
you do not have a host print server that supports it. 


* Whenever the printer supports Color Fidelity, but the print server does not, the 
following rules apply: 

— If no COLORVALUERR subcommand is issued, printing continues. However, 
color exception errors are reported and ignored. 

— If either COLORVALUERR STOP or COLORVALUERR CONTINUE 
NOREPORT are coded, the print server issues an error and stops printing, 
even if there is no color exception error. 

— If COLORVALUERR CONTINUE REPORT is coded, the print server 
continues printing. However, color exception errors are reported and ignored. 


TONERSAVER 
Specifies whether or not the printer's toner saver mode should be activated. When 
activated, this may degrade print quality, and may also impact performance. If 
DEVSETTING is specified, the specific device’s setting is used. If TONERSAVER ON or 
OFF is specified, it overrides any QUALITY parameters. This function is device specific. 


| 
| 
| 
| 
| 
| Make sure that your printers supports this feature by checking the printer's documentation. 
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COMMENT agstring 


CONSTANT 


CUTSHEET 


DIRECTION 


Specifies a string comment. Use COMMENT to mark a form definition with a user 
comment. The string is placed in the NOP structured field of the form definition. 


qstring Specifies a quoted set of strings up to a total of 255 characters. 


Note: In PPFA, a keyword or parameter (token) cannot extend across a line. Therefore, 
you must break the string into several strings in order to have a comment string 
that is longer than what fits on one line. Each string must be a complete token with 
beginning and ending quotes. For example: 


FORMDEF replace yes 
COMMENT 'first line of comment' 
"second line of comment'; 


PPFA composes the comment to be: 
first line of comment second line of comment 


and places it in a separate NOP structured field in the form definition. 


Specifies whether the constant-forms function is on or off and whether constant form is to 
be printed on the front or back sides of a sheet. 


NO Specifies that the constant forms function is off. 


BACK Specifies that a constant form is to be printed on the back side without 
variable data. 


FRONT Specifies that a constant form is to be printed on the front side without 
variable data. 


BOTH Specifies that a constant form is to be printed on both sides without 
variable data. 


If you are using a cut-sheet printer, this subcommand specifies whether the medium 
orientation information, which is coded using the DIRECTION and/or PRESENT 
subcommands, is to be passed to that printer. Not coding the CUTSHEET subcommand is 
equivalent to coding CUTSHEET NO. 


NO Specifies the rotation data is not to be passed unless, of course, N_UP is coded. 

YES _ Specifies the rotation data is to be passed. 

Note: As always: If you have a continuous form printer, the medium orientation 
information is passed. If you have a cut-sheet printer and N_UP is coded, the 


orientation information is passed. The default for a COPYGROUP for which no 
CUTSHEET subcommand is coded is to inherit the behavior of the FORMDEF. 


New: If you have a cut-sheet printer and CUTSHEET YES is coded, the orientation 
information is passed if you also have a level of print server that supports the 
CUTSHEET feature. 


In all cases: Before using this command, you must have a printer that allows its 
media origin to be changed. 


Determines, along with the PRESENT subcommand, how data is oriented on printers 
whose media origin can be changed. See the list of printers under the PRESENT 
subcommand. 


If you are printing line data, you usually specify the same value for the DIRECTION 
subcommand as is specified for the DIRECTION subcommand in the page definition. 


ACROSS Specifies that the pages are formatted in the ACROSS printing direction. 
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DUPLEX 


FINISH 


DOWN Specifies that the pages are formatted in the DOWN printing direction. 


If the DIRECTION subcommand is specified, you must specify the PRESENT 
subcommand. The default for DIRECTION is determined by the value specified for 
PRESENT. 


The direction default of PORTRAIT is ACROSS; the direction default of LANDSCAPE is 
DOWN. If neither PRESENT nor DIRECTION is specified, the default is PRESENT 
PORTRAIT and DIRECTION ACROSS. 


Specifies whether printing is done on both sides of the sheet. This subcommand should be 
used only for page printers that have duplex capability. 


NO Duplex printing is not performed. 


NORMAL Duplex printing is performed, with the tops of both sides printed along the 
same edge for side binding. 


TUMBLE Duplex printing is performed with the top of one side and the bottom of the 
other printed along the same edge of the sheet for top binding. 


RNORMAL Rotated normal. Duplex printing is performed with the top of one side 
printed along the same edge of the sheet as the bottom of the other. Used 
with landscape pages, N_UP 2, and N_UP 3. 


RTUMBLE Rotated tumble. Duplex printing is performed with the tops of both sides 
printed along the same edge. Used with landscape pages, N_UP 2, and 
N_UP 3. 


Specifies where the media should be stapled, folded, cut, or perforated. 


This option can only be used on a document, set of documents, or an entire print file. 
Finishing operations are device dependent; check your printer documentation before using 
the FINISH subcommand. 


Notes: 

1. The FINISH operation is used for printers with finisher attachments. 

2. The finishing operation must be specified at least once, and may occur more than 
once. It specifies finishing operations to be applied to the collected media. 

3. If more than one finishing operation is specified, the operations are applied in the order 
in which they are specified. Identical finishing operations for the same SCOPE are not 
supported. 

4. FINISH positions are not affected by DIRECTION or PRESENT values. 

5. Changing the orientation of the medium presentation space does not change the 
finishing corners or edges. 

6. For continuous forms media, the carrier strips are not considered to be part of the 
physical media. 


7. For saddle stitch operation, the staples are placed along the center of the media, 
parallel to the reference edge. Any offset value is ignored. If no OPCOUNT or OPPOS 
values are specified, the device default count is used. 


8. User-specified OPCOUNT and OPPOS values are ignored for FOLD, CUT, or 
PERFORATE operations. 


SCOPE Determines how the finishing operation is applied. 


PRINTFILE 
Determines that the specified finishing operations for the 
OPERATION subcommand are applied to the complete print file, 
excluding header pages, trailer pages, and message pages. 
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ALL Determines that the specified finishing operations for the 
OPERATION subcommand are applied individually to all 
documents in the print file. 


n Use the nto apply the finishing operation to a specific document. 
Use a value of 1 to apply the finishing operation to the first 
document in a print file. Use the value 2 to apply the finishing 
operation to the second document in a print file, and so on. The 
range of values includes 1-32,767. 


Specifies the type of finishing operation. 


CORNER Specifies that one staple is driven into the media at the 
reference corner (see REFERENCE parameter). For 
corner staples, the offset and angle of the staple from the 
selected corner is device dependent. 


SADDLE Specifies that one or more staples are driven into the 
media along the axis of the finishing operation, which is 
positioned at the center of the media, parallel to the 
reference edge (see REFERENCE parameter). 


EDGE Specifies that one or more staples are driven into the 
media along the axis of the finishing operation. 


FOLD Specifies that the media is folded along the axis of the 
finishing operation. 


CUT Specifies that a separation cut is applied to the media 
along the axis of the finishing operation. 


PERFORATE Specifies that a perforation cut is applied to the media 
along the axis of the finishing operation. 


PUNCH Specifies that one or more holes are to be punched or 
drilled into the media along the finishing axis. PUNCH is 
applied to he collected media, not to individual media. 


Determines the reference corner or edge of the finishing operation. 


DEFAULT Specifies that the device default determines the reference 
corner or edge. 


TOPLEFT Specifies that, for the finishing operation, the reference 
corner is positioned at the top in the left corner. This 
REFERENCE parameter can be used only for CORNER 
operations. 


TOPRIGHT Specifies that, for the finishing operation, the reference 
corner is positioned at the top in the right corner. This 
REFERENCE parameter can be used only for CORNER 
operations. 


BOTRIGHT Specifies that, for the finishing operation, the reference 
corner is positioned at the bottom in the right corner. This 
REFERENCE parameter can be used only for CORNER 
operations. 


BOTLEFT Specifies that, for the finishing operation, the reference 
corner is positioned at the bottom in the left corner. This 
REFERENCE parameter can be used only for CORNER 
operations. 
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TOP Specifies that, for the finishing operation, the reference 
edge is positioned at the top.° 


BOTTOM Specifies that, for the finishing operation, the reference 
edge is positioned at the bottom.® 


LEFT Specifies that, for the finishing operation, the reference 
edge is positioned at the left.” 


RIGHT Specifies that, for the finishing operation, the reference 
edge is positioned at the right.® 


OPCOUNT nl OPPOS n 


OPOFFSET n 


Specify either the number of finishing operations requested (see 
OPCOUNT), or the positions for each operation on the axis of the finishing 
operation (see OPPOS). 


OPCOUNT Use OPCOUNT to request a specific number of finishing 
operations; valid values are 1-122. Do not specify OPPOS 
values with OPCOUNT. If OPPOS is specified for corner 
staple, separation cut, perforation cut or fold, this 
OPCOUNT value is ignored. The printer determines the 
positions of the operations. The default is 0 (zero). 


OPPOS Use OPPOS io control the position of each operation on 
the axis of the finishing operation. The subparameter is an 
integer value in the range of 0-32,767, representing 
millimeters. Do not specify the unit of measure. Do not 
specify OPCOUNT when you use OPPOS. If OPPOS is 
specified for corner staple, fold, separation cut, or 
perforation cut, the OPCOUNT value is ignored. 


Specifies that the axis for the finishing operation is offset. The 
subparameter is an integer value in the range of 0-32,767, representing 
millimeters. Do not specify OPOFFSET for corner staple or saddle stitch; 
the corner staple or saddle stitch values areignored when specified with 
OPOFFSET. 


The following examples show how to specify finishing operations. 


To request scope as the entire print job with one corner staple in the top 
left corner, specify: 
FINISH SCOPE PRINTFILE OPERATION CORNER REFERENCE TOPLEFT; 


Sometimes a user wants to request multiple finishing operations. To 
request that the fifth document in the job stream be finished using top left 
corner staple and the ninth document be edge stitched only at the print 
default location, specify: 
FINISH SCOPE 5 

OPERATION CORNER 

REFERENCE TOPLEFT 


SCOPE 9 
OPERATION EDGE; 


FONTFID Indicates to the print server whether the form definition honors the fidelity of the specified 


5. This REFERENCE parameter can be used only for edge type operations (for example, SADDLE, EDGE, FOLD, CUT, 


PERFORATE). 


6. This REFERENCE parameter can be used only for edge type operations. 


7. This REFERENCE parameter can be used only for edge type operations. 


8. This REFERENCE parameter can be used only for edge type operations. 
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fonts when a raster font of a specified resolution and metric-technology cannot be found 
on the printer. In order to get the print server to honor this command you also must specify 
font resolution on either the FONT command or externally (for example, on the JCL). Not 
coding FONTFID is equivalent to coding FONTFID NO. 


YES _ Specifies that no substitution is allowed and the print server issues an error 
message if it cannot find the font that matches the specified resolution and metric. 


NO Specifies that the print server will not enforce font fidelity. The print server does 
not check for a match of the specified resolution and metric with the font found on 
the system. 


Notes: 


1. The FONTFID subcommand is designed to be used in concert with the 
RESOLUTION and METRICTECHNOLOGY subcommands on the FONT 
command, which are used to rigorously specify the font characteristics. 


2. This subcommand assists the user who has created a form definition and page 
definition for printing with a raster font on a printer of one resolution (for 
example, a 240 pel printer), and has moved that application to a printer of 
another resolution (for example, a 300 pel printer). When the print server 
cannot match the raster font, it substitutes an outline font, which often causes 
the placed text to overflow or underflow the intended space on the page. If this 
happens, the user can specify the actual metric and resolution of the font 
being used to print the text and also specify FONTFID YES, so that the print 
server would not substitute another font. 


Specifies where the next page of data is placed when this copy group is activated by 
conditional processing or by an Invoke Medium Map structured field. 


INVOKE SHEET, which is the default, places the next page of data on a new sheet. The 
NEXT, FRONT, and BACK parameters place the next page in a subsequent partition on 
the same sheet or, if no partitions are available, on the next sheet. If FRONT or BACK is 
specified, INVOKE selects only partitions on the front or back, respectively. 


Print servers honor the NEXT, FRONT, and BACK values of the INVOKE subcommand 
only if the new copy group has the same medium modifications as the previous copy 
group. Medium modifications include duplexing, bin, page offset, N_UP values, 
presentation, direction, and medium overlays. 


If any of these modifications differ, the print server ejects to a new sheet when the copy 


group is invoked. If you want to change overlays when ejecting to a new partition, use 
page overlays instead of medium overlays. See Medum Overays and Face Cvetayet on 
page 159|for information about page and medium overlays. 

When you use [PLACE]subcommands, the NEXT, FRONT, and BACK parameters place 
the next page using the next sequential PLACE subcommand that matches the 
requirement (next, front, or back). For example, if you print using the second PLACE 


subcommand of copy group A, and then you change to copy group B, you start with the 
third PLACE subcommand of copy group B. 


A CONSTANT parameter on the PLACE subcommand does not alter the selection 
process. The selection is complete, even though the selected PLACE subcommand does 
not place the data. N_UP performs the constant modification and continues until it finds a 
PLACE subcommand that does not specify CONSTANT. The data is placed with this 
subcommand. Observe that this PLACE subcommand need not match the FRONT or 
BACK specifications of the INVOKE subcommand. 


SHEET Specifies that data be placed in the first selected partition of the sheet. 
NEXT Specifies that data be placed in the next selected partition. 
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JOG 


OFFSET 


OUTBIN n 


FRONT Specifies that data be placed in the next selected front partition. 
BACK Specifies that data be placed in the next selected back partition. 


Specifies whether a JOG subcommand is sent to the printer when this FORMDEF is 
selected by an IMM structured field, or through conditional processing. When the JOG 
subcommand is sent, a printer either offsets (jogs) or prints copymarks. For cut-sheet 
printers, or for continuous-forms printers with burster-trimmer-stacker enabled, the JOG 
subcommand causes the first sheet controlled by this FORMDEF to be stacked offset from 
the previous sheets. For continuous forms printers without a burster-trimmer-stacker, the 
JOG subcommand causes an increment in the copymark printed on the carrier strip. JOG 
subcommands also are sent to the printer at the beginning of each data set or at the 
beginning of each job, depending on host parameters. For more information about 
copymarks, see the system programming guide for your host print server. 


YES __ Specifies that a JOG subcommand be sent to the printer. The first sheet printed is 
offset or the copymark is incriminated. 


NO Specifies that no JOG subcommand be sent to the printer. The first sheet printed 
is not offset; the copymark is not incriminated. 


Specifies the offset of the logical page for both the front and back pages in reference to 
the media origin. The media origin is printer dependent. For more information about media 
origin, see your printer publications or Advanced Function Presentation: Printer 
Information. 


If you specify offset values for the back of the page, you must also specify the front offset 
values. 


Note: The OFFSET subcommand does not affect the position of medium overlays. 


rel-x Specifies the relative horizontal offset of the logical page on the front or back side 
of the copy group relative to the media origin. The valid options for rel-x are 
described in the SETUNITS command for the horizontal value. 


The default unit is: 

* Taken from the last SETUNITS command 

* IN (inch) if no SETUNITS command has been issued 
°* 0.1 IN 


rel-y Specifies the relative vertical offset for the logical page for the front or back side of 
the page. The valid options for re/-y are described in the SETUNITS command for 
the vertical value. 


The default unit is: 

* Taken from the last SETUNITS command 

* IN (inch) if no SETUNITS command has been issued 
° 0.1 IN 


Notes: 

1. The vertical offset for the 3800 must be 0.5 inch or greater. 

2. You may specify this offset as negative in order to crop the top and/or left of 
an image. 


Specifies the destination bin number for any pages directed by this form definition. 
Copygroups and subgroups in this form definition that do not specify an output bin number 
inherit this bin number. 


n_ Specifies the output bin number. 
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PELSPERINCH n 
Specifies the Logical Units in pels per inch for this form definition. Use the PELSPERINCH 
parameter to tell PPFA the pel resolution of your printer to generate more exact object 
placements. 


n_ Specifies an integer number between 1 and 3,276, which determines the Logical Units 
in pels per inch. 


Note: If the L-Units are not specified on this form definition, they are defaulted to 240 pels 
per inch. 


FORMDEF xmp01 replace yes 
PELSPERINCH 300 ; 


COPYGROUP C1 
offset 2 in 3 in; 


COPYGROUP C2 
offset 2 in 3 in 
PELSPERINCH 1200; 


Figure 98. PELSPERINCH example 


In|Figure 98, the form definition xmp01 has specified L-Units as 300 pels per inch. 
Because the COPYGROUP C1 does not specify L-Units, it inherits 300 pels per 
inch. COPYGROUP C2 does specify L-Units as 1200 pels per inch. 


The code in COPYGROUP C1 (“offset 2 in 3 in”) produces internal and structured 
field values for x and y of 600 and 900, whereas in COPYGROUP C2 the same 
code produces values of 2400 and 3600, because of the difference in L-Units. 


PRESENT Specifies, along with the DIRECTION subcommand, how the data is oriented on printers 
whose media origin can be changed. 


The PRESENT and DIRECTION subcommands are only supported by cut-sheet printers 
when you specify the |N_UP|subcommand or the CUTSHEET subcommand with the YES 
parameter. See Figure 73 on page 142]through|Figure 76 on page 145]to determine the 
effect of the PRESENT and DIRECTION subcommands when you use them with the 
N_UP subcommand. 


PORTRAIT Specifies that the pages are printed in the portrait page presentation, with 
their short edges at the top and bottom and their long edges at the sides. 


LANDSCAPE Specifies that the pages are printed in the landscape page presentation, 
with their long edges at the top and bottom and their short edges at the 
sides. 


QUALITY n Specifies the print quality. This subcommand is recognized only on printers that can 
produce more than one level of print quality. The default is determined by the printer 
model. (On some printers, the default may be set at the printer itself.) For more 
information, refer to your printer publications. 


n You can select a level of print quality by entering any whole number from 1 to 10. 
Higher numbers correspond to higher levels of print quality; lower numbers 
correspond to lower levels. For more information, refer to your printer publications. 


Print quality is determined by a numerical code in the range of 1 to 254 (hexadecimal 
X'01'-X'FE'). The codes corresponding to the possible QUALITY parameters are: 


1 = 15 (X'0F’) 
2 = 40 (x'28') 
3 = 65 (X'41’) 
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REPLACE 


PROCESSING 


4 = 90 (X'5A') 

5 = 115 (X'73') 
6 = 140 (x'8C’) 
7 = 165 (X'A5') 
8 = 190 (X'BE’) 
9 = 215 (X'D7’) 


10 = 240 (X'FO’) 


Specifies whether this form definition is to replace an existing one with the same resource 
name in the library. 


YES Replace an existing form definition of the same name in the library if there is one. 
If a form definition with the same name does not exist in the library, then store this 
form definition. 


NO Do not replace an existing form definition of the same name. If a form definition 
with the same name does not exist in the library, then store this form definition. 


This is the default. 


Specifies additional post-processing capabilities for selected printers and attached 
equipment. This option can only be used on a single page or a set of pages. The 
subcommand expects one to three of the following keywords: 


MEDIA_INFO n 
This parameter specifies the ID of fixed medium information that a printer 
or printer—attached device applies to a page. Examples such as color 
plates logos, letter heads, and other fixed images. 


The numeric values that can be included are: 


0-254 These numeric values select a particular fixed medium local ID 
that the printer or printer—-attached device applies to a sheet. One 
or more IDs can be specified within this range. 


255 This value selects all the current fixed medium local IDs that the 
printer or printer—attached devices applies to a sheet. 


PERFORATE Specifies a perforation cut at one or more fixed locations on the sheet 
according to the printer or printer—attached device. 


CUT Specifies a separation cut at one or more fixed locations on the sheet 
according to the printer or printer—attached device. 


N_UP {1121314} 


Specifies the number (1, 2, 3, or 4) of equal-size partitions into which the sheet is divided. 
See the that support the N_UP subcommand. 


If you do not specify the N_UP subcommand in the COPYGROUP command, the N_UP 
subcommand from the FORMDEF command is the default for the COPYGROUP 
command. You can mix N_UP printing and non-N_UP printing by specifying or not 
specifying the N_UP subcommand in each copy group and by not specifying N_UP in the 
FORMDEF command. 


OVERLAY name 
Specifies the name of an overlay to be placed with every page in each of the N_UP 
partitions. The overlay is placed relative to the page origin, or if the PARTITION 
parameter is specified, relative to the partition origin. You can specify a maximum of 
254 OVERLAY subcommands in a copy group. 


X-POS y-pos Specifies the horizontal and vertical adjustment to the position of the 
overlay. This is in addition to any offset values built into the overlay. 
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The x and y values must be positive (+). You can specify them in 
inches (IN), millimeters (MM), centimeters (CM), points, or pels. If you 
do not specify a unit value, PPFA uses the unit value specified in the 
last SETUNITS command or uses a default unit value of inches. 


Note: This OVERLAY subcommand cannot be specified if the PLACE 
subcommand is specified. Use the OVERLAY parameter of the 
PLACE subcommand instead. 


OVROTATE { 01! 90 | 180 | 270 } 
Specifies the rotation of the placed overlay with respect to the x-axis of the page. 


Example: 


Assuming the overlay has ( 0,0 ) placement coordinates, this causes page overlay “x2” 
to be placed 1.5 inches to the right and 2.7 inches below the beginning of the page 
and rotated 90 degrees clockwise with respect to the page. 
Formdef f1 

N_UP 1 PLACE 1 FRONT 


OVERLAY x2 1.5 in 2.7 in 
OVROTATE 90; 


PLACE 
Places a page of data or a constant modification relative to a partition. Each PLACE 
subcommand specifies the number n of a partition on either the front or back side of 
the sheet. FRONT is the default, if you do not specify this subcommand. You must 
specify the same number of PLACE subcommands as the number of partitions on the 
sheet. The sequence of the PLACE subcommands is the sequence in which incoming 
pages are placed in the partitions. 


Note: The PLACE subcommand is valid only on printers that support enhanced N_UP 
printing. If PLACE is not specified, pages are placed in partitions in the default 
partition sequence. 


n Specifies the numbered partition (1—4) into which the page of data is placed. 


FRONT 
Specifies that this partition be placed on the front side of the sheet. 


BACK Specifies that this partition be placed on the back side of the sheet. 


CONSTANT 
Specifies that no page data is placed by this PLACE subcommand. 


Use CONSTANT when you are placing overlays without user’s data or are 
placing fewer data pages on the sheet than the number of partitions specified 
in the N_UP subcommand. 


For an example of using the CONSTANT parameter with overlays and to 
understand how the ordering of the PLACE subcommand affects overlays, see 
OFFSET rel-x rel-y 
Specifies a relative offset of the page horizontally (x) and vertically (y) from the 
partition origin. If OFFSET is not coded, PPFA uses the value of 0.1 inch for 
both the x and y offsets. This OFFSET parameter overrides any other 
OFFSET parameters specified on the FORMDEF or COPYGROUP command. 
You can specify the units in inches (in), millimeters (mm), centimeters (cm), 
points, or pels. If you do not specify a unit value, PPFA uses the unit value 


specified in the last SETUNITS command or uses a default unit value of 
inches. 
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Note: You may specify this offset as negative in order to crop the top and/or 
left of an image. 


OVERLAY name 
Specifies the name of an overlay to be placed with this PLACE subcommand. 
The overlay is placed relative to the page origin or, if the PARTITION keyword 
is specified, to the partition origin. You can specify multiple OVERLAY 
parameters in each PLACE subcommand. 


X-pos y-pos 
Specifies the horizontal and vertical adjustment to the position of the 
overlay. This is in addition to any offset values built into the overlay. 
The x and y values must be positive (+). You can specify them in 
inches (IN), millimeters (MM), centimeters (CM), points, or pels. If you 
do not specify a unit value, PPFA uses the unit value specified in the 
last SETUNITS command or uses a default value of inches. 


PARTITION 
Specifies that the previous offset is from the partition origin. If not 
present, the offset is from the page origin, which is subject to the 
OFFSET parameter. 


OVROTATE {01 901 1801 270} 
Specifies the rotation of the placed overlay with respect to the x-axis 
of the page. 


ROTATION {01 90 | 180 | 270 } 
Specifies the clockwise rotation of the page and associated page overlays 
placed by this PLACE command. 


Rotation turns the page and its associated page overlays around their fixed 
origin points. If you rotate the page without moving its origin point, you might 


rotate it off the physical medium. To prevent this, always offset the page origin 
to the place you want it to be for the rotated page, as shown in|Figure 99 


1 Inch 


Tl i 9 inch 


ih 
90° 


Page den 1 in., 1 in. Page offset 9 in., 1 in. 


1 Inch 
1 Inch 
ebeY 


>k Page origin 
e Partition origin 


Figure 99. Offsetting the Page Origin for Rotated Pages 


VIEW Determines if this NUP PLACE page is viewable. VIEW is relevant only when 
the page is being presented on a display. VIEW is ignored if the page is being 
printed. If VIEW is not coded, it is equivalent to specifying VIEW YES. 


YES __ Specifies that this N_UP page is viewable and is presented. 
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NO Specifies that this N_UP page is not to be presented. 


VFYSETUP verificationID ... 
Use specifically for the IBM Infoprint 4000 Highlight Color post processor to propagate the 
setup IDs to all medium maps (copygroups) in the form definition. Do not specify 
VFYSETUP on the COPYGROUP command. Before using the VFYSETUP subcommand, 
verify that your version of print server supports FORMDEF setup verification. 


To use VFYSETUP, specify one or more 4-character identifier sets that match the Setup 
Verification IDs defined at the printer operator's console for the specific print job. For 
example, if the Setup Verification IDs defined at the printer were X'012F', X'0521', and 
X'938A', specify the following: 

FORMDEF vfy7 REPLACE YES VFYSETUP 012F 0521 938A; 


When the print server processes the print job, it compares the setup verification IDs in the 
form definition to the IDS that are active in the printer. If the active IDs in the printer do not 
match the IDs required by the form definition, or if the printer does not support FORMDEF 
setup verification IDs, the job is held. 


Chapter 9. Form Definition Command Reference 199 


OVERLAY Command 
OVERLAY Command 
OVERLAY Command 


Cony 
>>— OVERLAY 


>< 


name 2. 3 
Lane Laster — 


This OVERLAY command identifies an electronic medium overlay to be used in one or more subgroups of 


a copy group, see|“Medium Overlays and Page Overlays” on page 159]for additional information. When 


using the OVERLAY command, follow these guidelines: 

¢ An OVERLAY command comes after the COPYGROUP command. 

¢ A separate OVERLAY command must be specified for each electronic overlay used in a subgroup. 

* Amaximum of 254 OVERLAY commands can be specified for coded overlays per copy group. 

¢ The overlay named here must be referenced in a SUBGROUP command in order to be printed (see 
page [204). 

Notes: 

1. Overlays contain their own positioning controls. 


2. This does not define page overlays, that are placed using the N_UP subcommand. See [Medium 
Overlays and Page Overlays” on page 159] for additional information. 
OVERLAY [ name? ] name2 
Identifies an electronic overlay to be used in one or more subgroups of a copy group. 


name1 


Specifies an alphanumeric name of 1 to 16 characters (local name) for the overlay. 


It must conform to the token rules and must be unique within a copy group. 


Note: If name7 is omitted, name2 is used as the local name and is the name 
used in the subgroup command. 


name2 


Specifies an alphanumeric name of 1 to 6 characters (user-access name) for this 


overlay. A prefix of O7 is added by PPFA to identify the overlay resource. 


Subcommand 


RASTER or NORASTER? 
Specifies overlays as raster or not raster data. 


RASTER Specifies this overlay is to be kept in the printer as raster data. If this overlay is to be 


used several times, the printer does not need to recompile it each time. 


Note: This function is ignored by PSF for AIX. One raster overlay can be specified per 


copy group. 


NORASTER _ Specifies this is a coded overlay. A maximum of 254 coded overlays can be specified 


per copy group. 


9. The RASTER or NORASTER subcommands are used only on the IBM 3800 printers. 
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C 1 —IN— 1 SS 
>>—SETUNITS | | ; >< 

xX 4 LINESP—n IN 
IN IN MM. 
MM. MM. CM 
CM CM POINTS 
POINTS POINTS PELS 
PELS PELS L_| PI 

_-¢p]——_ -_| PI—_ 


The SETUNITS command specifies the value and the unit of measurement that is the default for any 
subsequent measurement parameter in all of the commands and subcommands. These values remain the 
default values until another SETUNITS command is specified. The SETUNITS command should be 
specified as the first command in a form definition. If neither this command nor a measurement parameter 
is specified, the defaults identified within the following description are used. 


SETUNITS Specifies the value and the unit of measurement that is the default for any subsequent 
measurement parameter in all of the commands and subcommands. 


x-pos Specifies the number used for horizontal measurement. A number with up to three 
decimal places may be used. The default is 1. The unit choices are IN, MM, CM, 
POINTS, PELS, or CPI. 


Note: This value affects subsequent OFFSET subcommands. 


y-pos Specifies the number used for vertical measurement. A number with up to three 
decimal places may be used. The default is 1. The unit choices are IN, MM, CM, 
POINTS, PELS, or LPI. 


Note: This value affects subsequent OFFSET subcommands. 
Using CPI and LPI Units of Measurement 


The CPI and LPI units of measurement make it possible to write the following command: 
SETUNITS 10 CPI 6 LPI ; 


This command sets the units of measurement for horizontal and vertical spacing in terms 
of characters per inch and lines per inch. You can then use the OFFSET subcommand 
specifications to increment the spacing one character or one line at a time. The distance 
specified by n characters over and by n lines down is defined in the governing SETUNITS 
command. In this example, there are 10 characters per inch (CPI) and 6 lines per inch 
(LPI). 


Subcommand 


LINESP n 
This subcommand is to be used within a page definition to set up default line spacing; it serves no 
purpose when used within a form definition. 
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SUBGROUP Command 
SUBGROUP Command 
SUBGROUP Command 


-—-FLASH—NO: --BOTH— 
>>— SUBGROUP = 


COPIES—n | FLASH—YES | BACK 


'-FRONT— 
BIN—1 
>. > 
BIN 
n MEDIANAME—qs tring | COMPID—m 
MANUAL 
'_ENVELOPE— 


>< 


Lourgin—n | 


7 _| | ecw MA _ | 


The SUBGROUP command specifies the number of copies of a single page that are to be printed and any 
modifications (consisting of overlays, suppressions, type of duplexing, and forms flash) to be made to the 
copies. ASUBGROUP command follows a};COPYGROUP| command; a maximum of 127 SUBGROUP 


commands can be specified within each copy group. 


OVERLAY 


Notes: 


1. The BOTH subcommand causes two subgroups to be generated. Thus, a maximum of 63 subgroups 
can be specified when the BOTH subcommand is used. 


2. When you specify the DUPLEX subcommand (with a parameter other than NO) in the COPYGROUP 
command, you must include one SUBGROUP command for each side of a sheet, or you may specify 
the BOTH subcommand in a single SUBGROUP command. 


Subcommands 
COPIES n Specifies how many copies of each page are to be printed. 


n_ Defines the number of copies (the maximum number is 255). When BACK is 
specified within a SUBGROUP command, the system counts the front pages printed 
(the actual number of sheets) not copies made (front and back). The default is 1. 


FLASH’? Specifies whether to use forms flash. 
Note: When forms flash is used, its name must be specified in the job control language 


for the print job. The operator must place the correct negative into the 3800 when 
the job is ready to print. 


NO Specifies that forms flash does not occur. 
YES _ Specifies that forms flash occurs. 


{ BACK or FRONT or BOTH } 
These optional subcommands specify whether the subgroup is for both sides of a sheet or 
for only the front or the back side. 


10. The FLASH subcommand is used only on the IBM 3800 printers. 
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BIN 


Rules:: 


SUBGROUP Command 


1. Subgroups must specify FRONT and BACK if an overlay, suppression, or forms flash 
appears on one side but not on the other. 

2. The FRONT and BACK subgroups must have the same number of copies. 
If the number of copies differs, the COPIES parameter of the BACK subgroup is 
ignored, and a warning message is issued. 

3. The FRONT and BACK subcommands must occur in pairs. 

4. If the FRONT and BACK subcommands are specified with DUPLEX NO (in the 
FORMDEF or COPYGROUP commands), PPFA issues an error message and does 
not create the form definition. 


BACK 


FRONT 


BOTH 


Specifies this SUBGROUP command is for the back sides of the sheets. 


A subgroup with a BACK subcommand must have a FRONT 
subcommand in the preceding subgroup. 


Specifies this subgroup is for the front sides of the sheets. 


If a DUPLEX subcommand in a FORMDEF or COPYGROUP command is 
specified with a parameter other than NO and the FRONT subcommand is 
specified in a SUBGROUP command, the next SUBGROUP command 
must have a BACK subcommand. 


Specifies this subgroup is used for both sides of the sheet. 
This is the default wnen DUPLEX is specified in the copy group. 


If BOTH is specified with DUPLEX NO (in a FORMDEF or COPYGROUP 
command), PPFA issues a warning message and ignores the BOTH 
subcommand. 


Specifies the paper source. This subcommand should be used only for printers that have 
more than one paper source. 


Note: If you specify the BIN subcommand, you must also specify at least one of the legal 
parameters. 


2-255 


MANUAL 


An integer number between 1 and 255 that is the Media Source Id (also 
known as the bin number). 


Selects the primary paper source. 


Selects another paper source. If the specified bin does not exist on your 
printer, the default paper source for that printer is used. For more 
information about paper sources on your printer, refer to your printer 
publications. Using a value of 100 is the same as specifying MANUAL. 


Selects manual feed as a paper source on those printers that support manual 
feed. For more information, refer to your printer publications. 


ENVELOPE 


Selects an envelope paper source on those printers that support this function. For 
more information, refer to your printer documentation. 


Notes: 


BIN selection is overridden by the printer if the form defined to each bin is the 
same form number. Only the primary bin is selected. 


1. 
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SUBGROUP Command 


OUTBIN n 


OVERLAY 


SUPPRESSION 


2. The primary source usually contains either letter-size (U.S.) or A4 (I.S.O.) 
paper. Other paper sources are used for less common paper sizes (such as 
legal-size) and for special paper (such as colored stock or pre-printed 
letterhead on heavy bond). 


3. If duplexing is requested and you select from the front side from one bind and 
the back side from another bin, a warning message is issued and the printer 
takes the paper from the bin specified on the front side. 


MEDIANAME 
Selects a media source by specifying an agreed upon name for the bin. For a 
current list of the valid media names, see [Appendix F “PFA Media Names” on] 
qstring Up to 12 characters within single quotes specifying the media source 
name. On some printers, this name is pre-set into the printer; on others, it 


also can be entered into the printer by the user. Refer to your printer 
documentation for further information. 


COMPID m 
Selects a bin based on the component id. 


Note: For a current list of component ids, see|Appendix F, “PPFA Media Names” 


on page 4351 Component ids from 12,288 to 268,435,455 are reserved for 
the user. 


Specifies the destination bin number for any pages directed by this form definition. 
Copygroups and subgroups in this form definition that do not specify an output bin number 
inherit this bin number. 


Specifies the electronic overlay that is to be used with this subgroup. 


name_ Specifies either the local or user-access name. A maximum of eight names can be 
specified within a subgroup. 


Notes: 


1. If the local name is used, it must be defined in an OVERLAY command before it can 
be referenced. 


2. PPFA does not check for duplicate user-access names. 


Specifies that the named field is suppressed. 


name Specifies a alphanumeric name of 1 to 8 characters (local name) of the text field 
to be suppressed. A maximum of eight names can be specified within a subgroup. 


The suppression field named here must be defined in a SUPPRESSION command 
following the FORMDEF command before it can be referenced. See page 


Note: This is for text only fields. 
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SUPPRESSION Command 
SUPPRESSION Command 


SUPPRESSION Command 
>>—SUPPRESSION—name—; 


<< 


A SUPPRESSION command, if used, must immediately follow the FORMDEF command. It names the 
suppression that is specified in the FIELD command of a page definition associating the form definition 
and the page definition. 


SUPPRESSION name 
Identifies an alphanumeric name of 1 to 8 characters (local name). The name must 
conform to the token rules. 


You must specify the area to be suppressed in a FIELD command or a SUBGROUP 
command using one of the names specified within this series of SUPPRESSION 
commands for the suppression to be effective. 

Notes: 


1. The SUPPRESSION command is for text only fields. It does not work for barcodes or 
other non-text fields. 


2. Amaximum of eight suppressions can be specified for one SUBGROUP command, 
and a maximum of 127 suppressions can be specified within one form definition. 
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Chapter 10. Page Definition Command Reference (Traditional) 


This section is for Traditional Line Data Processing (for Record Formatting Line Data Processing, refer to 
Chapter 11, “Page Definition Command Reference (Record Formatting and XML)” on page 263), and 


includes: 

* Sequence of commands for page definitions 

¢ Page definition commands listed alphabetically 

* Detailed information on each command 

* Descriptions of the applicable subcommands and parameters for each command 


Sequence of Traditional Commands for Page Definitions with 
PRINTLINE 


PAGEDEF [ SETUNITS ... ] 


[_ FIELD | CONDITION ...] 


] 
FIELD | CONDITION ...] ...] 


TTRCREF| . 
ISEGMENT, 


OVERLAY] .. 


FIELD | CONDITION ...] 


IENDSUBPAGE| ] 


PRINTLINE| [ FIELD | CONDITION ...] ...] 


¢ FONT commands must be specified immediately after a PAGEDEF command. The exception is the 
SETUNITS command. 


* OBJECT commands must be specified immediately after any FONT commands and before any 
PAGEFORMAT or other commands, except the SETUNITS command. 


¢* A SETUNITS command can be placed before any other PPFA command. The values set are in effect 
until the next SETUNITS command. 

¢ TRCREF, SEGMENT, and OVERLAY commands must be specified under their associated 
PAGEFORMAT command. 


The first}; PAGEFORMAT|command can be omitted in a page definition, if the Ac definition contains 


only one page format. If the PAGEFORMAT command is omitted, the command parameters 
are used to define the page format. 


¢ At least one |PRINTLINE| command is required per page format for Traditional Line Data Page definition. 
PRINTLINE and LAYOUT commands cannot be used within the same page definition. 


¢ An|ENDSUBPAGE|command can occur anywhere in a page definition that a PRINTLINE command can 
occur, except it can not occur between a|PRINTLINE| command and its associated |FIELD| and 
[CONDITION 


NDITION| commands. 
* One file can contain multiple sets of page definitions. 


Diagram Shorthand 


These terms are used in the command definitions: 


X-pos A vertical position using a numeric number followed optionally by a unit. For the available units, 
see|“Units of Measurement” on page 166 
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y-pos Ahorizontal position using a numeric number followed optionally by a unit. For the available units, 
see|“Units of Measurement” on page 166 
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CONDITION Command (Traditional) 


CONDITION Command (Traditional) 


CONDITION Command 


--SPACE_THEN_PRINT—YES— 


>>—CONDITION—condname—START—n—LENGTH—n > 
L-SPACE_THEN_PRINT—NO— 
| BEFORE SUBPAGE NEWFORM 
>—WHEN CHANGE > 
EQ text’ AFTER, LINE, NEWS IDE 
NE CURRENT or = CURRENT or = ———— 
GT. FIRST. FIRST. 
GE NULL or / NULL or / 
LT. NEXT. NEXT. 
ULE L-COPYGROUP cgname— ‘'-PAGEFORMAT pfname— 
> : >< 
BEFORE SUBPAGE NEWFORM 
_OTHERWISE: 
AFTER LINE: NEWS IDE 
CURRENT or = CURRENT or = ———— 
FIRST. FIRST. 
L-NULL or / NULL or / 
NEXT. NEXT. 
L-COPYGROUP cgname— ‘'-PAGEFORMAT pfname— 
Short Form 


>>—CONDITION—condname 


CONDITION 


>< 


| start—n 


The CONDITION command examines data in an input record and specifies actions to be taken based on 
the result of the examination. 


* The condname parameter must come before any subcommands 
* No WHEN subcommand can follow an OTHERWISE subcommand in the same CONDITION command 


condname 


Names the condition. The name must contain 1 to 8 alphanumeric characters. 


PPFA allows cross-referencing to the condname. The cross-reference is done by using the 
short form of the CONDITION command (second format in the syntax table). By specifying 
a previously defined condname, PPFA uses the specifications from that command. When 
the condition is reused, the point where you want the comparison to begin may be at a 
different point in the record. By specifying the optional START subcommand, you can 
change the starting point of the comparison but not the field length. If the START 
subcommand is not specified, the starting point is the same as defined in the original 
CONDITION command. 


Subcommands 


START n 


Specifies the starting byte of the comparison field within the data record where the 
comparison is to be done. 


n_ Specifies the number of bytes from the first data byte in the record as the starting 
point of the comparison field. The first data byte position of an input record is 1. 
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LENGTH n 


SPACE_THEN_ 


WHEN 
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Note: The carriage-control character and the table-reference character are not 
considered data. 


Specifies the length of the comparison field. 


n_ Specifies the number of bytes in the data record to be compared, beginning with the 
position specified in START. Valid values are numbers from 1 to 8000. The length of 
the constant text must be the same as defined in this parameter or the results are 
invalid. 


Comparisons are done on a byte-by-byte basis. Because the comparison field and the 
constant text must have the same lengths, padding is not necessary. 


Note: If any part of the comparison field specified by the combination of START and 
LENGTH is outside the boundaries of the data record, all conditional processing is 
not performed. No WHEN is executed. If an OTHERWISE is present, it is not 
executed either. 


PRINT 

Specifies whether ANSI carriage controls for spacing are enabled for the first record on the 
new logical page following the execution of the CONDITION command. The abbreviation 
of this command is SPACE. 


YES Specifies that the ANSI carriage-control character in the first print record of the 
new page is enabled for spacing. The spacing action specified in the carriage 
control is performed after the eject to the new page. For example, if the 
carriage-control byte in the first record of the new page is a blank (skip one line 
before printing), then the first record skips the first line of the new page and prints 
at the second printline position. 


NO Specifies the ANSI carriage-control character spacing action is suppressed for the 
first print record of the new page. If this record contains a carriage-control spacing 
value, such as “blank”, “O”, or “—’, the spacing is ignored and the record prints at 
the first printline position on the new page. Channel code values are not ignored. 
If the first print record contains a valid channel code value of 1-9, or A-C, then 
the first record on the new page prints at the printline defined with that channel 
code. 


Note: This subcommand is effective for print files that contain ANSI carriage controls. It is 
not used for data files containing machine carriage controls, or a mixture of ANSI 
and machine carriage controls. 


Marks the start of the conditional comparison parameters. At least one WHEN 
subcommand is required. 


comparisontype= { EQ! NE | GT 1 GE1LT1| LE} 
Specifies the type of comparison that is to be performed between the data 
in the comparison field (the portion of the record specified by START and 
LENGTH) and the constant text defined in the text parameter. 


The choices are: 

EQ equal to 

NE not equal to 

GT greater than 

GE greater than or equal to 
LT less than 


LE less than or equal to 


s Guide 


text 


CHANGE 


BEFORE 
AFTER 
LINE 


SUBPAGE 


NEWFORM 


NEWSIDE 


CONDITION Command (Traditional) 


Specifies constant text for comparison with the comparison field text. The 
constant text length must be the same as the value on the[LENGTH| 
subcommand, with a maximum length of 8000 bytes. Examples of valid 
text are: 

2C(3) 'AB' 

K'321,400' 

X'41FE7799' 2 'CHARS' 


Any values or parameters that are valid for the TEXT subcommand within 
the FIELD command may be used as text. 


Specifies that the contents of the comparison field in this record are to be 
compared with the field in the record last processed by the same 
CONDITION command. 


This parameter is an alternative to the comparisontype and text parameter 
combination but can be specified only once in a CONDITION command. 


The results of the comparison is either TRUE or FALSE. 


TRUE When the contents of the comparison field have changed 
from one record to the next. 


FALSE When the print server processes the data, if the 
comparison field lies outside the boundary of the current 
record, which may occur with variable-length records or 
with truncated trailing blanks, the current record is not 
used in future comparisons. 


CHANGE is always false if used with the first WHEN 
subcommand of a series (no previous record to compare 
against). Whenever a new data map (one with a different 
name) is invoked, all the CHANGE comparisons are reset. 
Field values in the previous data map are not retained. 


Specifies that the conditional action takes place before the current line or 
subpage is processed. This is the default. 


Specifies that the conditional action takes place after the current line or 
subpage is processed. 


Specifies that the conditional action takes place either before or after the 
current line. 


Specifies that the conditional action takes place either before or after the 
current subpage. This is the default. 


For a description of subpages, see |“Logical Page” on page 7 


NEWFORM specifies that the only action to be taken is skipping to the 
front of a new form (sheet) and restarting the page format. 


Note: This parameter is an alternative to using the COPYGROUP and 
PAGEFORMAT parameters, and is equivalent to specifying 
CURRENT for the COPYGROUP parameter and NULL for the 
PAGEFORMAT parameter. CURRENT NULL are the respective 
defaults for COPYGROUP and PAGEFORMAT parameters; 
therefore, NEWFORIM is the default action. 


Specifies that the only action to be taken is skipping to a new side (either 
the back of the current sheet or the front of a new sheet) and restarting 
the page format. 
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Notes: 

1. This parameter is an alternative to using the COPYGROUP and 
PAGEFORMAT parameters, and is equivalent to specifying NULL for 
the COPYGROUP parameter and CURRENT for the PAGEFORMAT 
parameter. 


2. Conditional processing does not result in unnecessary blank pages. 


If the line currently being processed is the first line on a side, then: 
* a COPYGROUP or NEWFORM action taking effect BEFORE LINE 
does not force an additional new form. 


* a PAGEFORMAT or NEWSIDE action taking effect BEFORE LINE 
does not force an additional new side. 


Similarly, additional sides or forms are not forced by BEFORE SUBPAGE 
if the line currently being processed is in the first subpage on a side or a 
form. 


copygroup options 


Specifies a copy group to be invoked if the condition is true. 


Note: Any copy group action (except NULL) restarts the page format. 


{ CURRENT or = } 


FIRST 
{ NULL or /} 


NEXT 


Invoke the current copy group again. This results in ending printing on the 
current sheet and resuming on the front side of a new sheet. This is the 
default. 


The page format is restarted. This means that the first input record to go 
on the new page is printed using the first PRINTLINE command of the 
current page format, and so on. For example, data that was to be printed 
as subpage 4 on the sheet might be printed on subpage 1 on the new 
sheet. 


Note: The character “=” can be used for CURRENT. 
Invokes the first copy group in the current form definition. 


Retains the current copy group, taking no action. The character “/’ can be 
used for NULL. 


Invokes the next copy group in the current form definition. 


Note: If NEXT is specified from the last copy group in the form definition, 
the first copy group in the form definition is used. 


COPYGROUP cgname 


Uses the named copy group defined in the current form definition. The 
name must contain 1 to 8 alphanumeric characters. 


pageformat options 


Specifies a page format to be invoked if the condition is true. 


{ CURRENT or = } 


PPFA User’s Guide 


Invokes the current page format again. This results in ending printing on 
the current sheet and resuming on the front side of a new sheet. 


The page format is restarted. This means that the first input record to go 
on the new page is printed using the first PRINTLINE command of the 
current page format, and so on. 


OTHERWISE 


CONDITION Command (Traditional) 
The character “=” can be used for CURRENT. 
FIRST Invokes the first page format in the current page definition. 


{ NULL or/} Retains the current page format, taking no action. The character “/” can be 
used for NULL. This is the default. 


NEXT Invokes the next page format in the current page definition. 


Note: If NEXT is specified from the last page format in the page 
definition, the first page format in the page definition is used. 


PAGEFORMAT pfname 


Uses the named page format defined in the current page definition. The 
name must contain 1 to 8 alphanumeric characters. 


have proved false. The syntax is the same as the subcommand, except that the 


comparison parameters (comparisontype text or ‘CHANGE’) are not used. See the WHEN 
parameters starting with J]BEFORE|on page for a description of the parameters. 


Marks the start of a conditional action to be taken if all receding WHEN comparisons 


If the OTHERWISE subcommand is not used within the sequence, no action is taken. This 
is the same as if an OTHERWISE NULL NULL had been entered. 


Note: OTHERWISE is not executed if any part of the comparison field specified by the 
combination of START and LENGTH is outside the boundaries of the data record. 
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DEFINE COLOR Command (Traditional) 


DEFINE COLOR Command 
>>—DEFINE—colorname—COLOR 


OCA BLUE ; >< 


DEFINE COLOR 


RED. 
t-MAGENTA or PINK 
GREEN 

t-CYAN or TURQ 
YELLOW. 

BLACK: 

BROWN 

MUSTARD 
t-DARKBLUE. 
L-DARKGREEN 
—DARKTURQ or DARKCYAN 
ORANGE 

PURPLE 

GRAY 

NONE 

DEFAULT. 
RGB—rvalue—gvalue—bvalue 
t-CMYK—cvalue—mvalue—yvalue—kvalue 
t-HIGHLIGHT—hvalue 


__COVERAGE—cvalue | BLACK—bvalue | 
CIELAB—Ivalue 7 clvalue 7 c2value 
_(-) _(-) 


Defines a color name of a particular color model such as OCA, RGB, CMYK, 
HIGHLIGHT, or CIELAB. This name can be used anywhere color of that model is allowed. 
For example a defined color of any color model can be used as text color in the FIELD or 
PRINTLINE commands, but only a color defined as an OCA color can be used as an 


object placement area color. See the OBCOLOR subcommand in|“PRINTLINE Command 
(Traditional)” on page 244 


colorname Select a 1 to 10 character name. Use this name on the command to 
identify this color. For example: 
DEFINE oldblue COLOR OCA brown; 
PRINTLINE COLOR oldblue; 
Subcommands 
COLOR Specifies the color of print for this field supported in MO:DCA for the OCA, the 


Red/Green/Blue color model (RGB), the highlight color space, the 
Cyan/Magenta/Yellow/Black color model (CMYK), and the CIELAB color model. 


OCA _ Chose one of the standard OCA colors from the previous syntax diagram. 
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In some printer publications, the color turquoise (TURQ) is called “cyan”, 
and the color pink (PINK) is called “magenta”. 


PPFA supports the following synonyms: 
* CYAN for TURQ 

* DARKCYAN for DARKTURQ 

* DBLUE for DARKBLUE 

* DCYAN for DARKTURQ 

* DGREEN for DARKGREEN 

* DTURQ for DARKTURQ 


DEFINE COLOR Command (Traditional) 
¢ MAGENTA for PINK 


RGB rvalue gvalue bvalue 
Three RGB integer values are used. The first (rva/ue) represents a value for red, 
the second (gva/ue) represents a value for green, and the third (bvalue) 
represents a value for blue. Each of the three integer values may be specified as 
a percentage from 0 to 100. 


Note: An RGB specification of 0/0/0 is black. An RGB specification of 
100/100/100 is white. Any other value is a color somewhere between black 
and white, depending on the output device. 


HIGHLIGHT hva/ue COVERAGE cvalue BLACK bvalue 
Indicates the highlight color model. Highlight colors are device dependent. 


You can use an integer within the range of 0 to 65,535 for the hvalue. 


Note: An hvalue of 0 indicates that there is no default value defined; therefore, 
the default color of the presentation device is used. 


COVERAGE indicates the amount of coverage of the highlight color to be used. 
You can use an integer within the range of 0 to 100 for the cvalue. If less than 100 
percent is specified, the remaining coverage is achieved with the color of the 
medium. 


Note: Fractional values are ignored. If COVERAGE is not specified, a value of 
100 is used as a default. 


BLACK indicates the percentage of black to be added to the highlight color. You 
can use an integer within the range of 0 to 100 for the bva/ue. The amount of 
black shading applied depends on the COVERAGE percentage, which is applied 
first. If less than 100 percent is specified, the remaining coverage is achieved with 
black. 


Note: If BLACK is not specified, a value of 0 is used as a default. 


See |‘Color on the IBM Infoprint HiLite Color Post Processor’ on page 47|for more 


information. 


CMYK cvalue mvalue yvalue kvalue 
Defines the cyan/magenta/yellow/black color model. cvalue specifies the cyan 
value. mvalue specifies the magenta value. yvalue specifies the yellow value. 
kvalue specifies the black value. You can use an integer percentage within the 
range of 0 to 100 for any of the CMYK values. 


CIELAB Lvalue (-)c1value (-)c2value 
Defines the CIELAB model. Use a range of 0.00 to 100.00 with Lvalue to specify 
the luminance value. Use signed integers from -—127 to 127 with c1value and 
c2value to specify the chrominance differences. 


Lvalue, c1value, c2value must be specified in this order. There are no defaults for 
the subvalues. 


Note: Do not specify both an OCA color with the COLOR subparameter and an 
extended color model on the same FIELD or PRINTLINE command. The 
output is device dependent and may not be what you expect. 
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ENDSUBPAGE Command (Traditional) 


ENDSUBPAGE Command 
>>—ENDSUBPAGE—; 
The ENDSUBPAGE command is used to identify the end of a subpage for conditional processing. 
You can specify the ENDSUBPAGE command at any point in a page definition command stream where a 
PRINTLINE or LAYOUT command can occur. However, you must not enter the ENDSUBPAGE command 
between a PRINTLINE or LAYOUT command and its associated FIELD or CONDITION command. 


If an ENDSUBPAGE command is not specified, the entire page format is treated as one subpage. 
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FIELD Command 


FIELD Command (Traditional) 


>>—FIELD TEXT. 


on_| 


ad Cc text’ 


X L(m) | 


LK 


LENGTH—n 


L_START—b Wie! 


--POSITION—CURRENT or * —CURRENT or * 


FONT—name1l 
im neneo!! 


2 


DIRECT ION—ACROSS—— 


_POSI ane i 


CURRENT or * 


Jb -s7 ig a 
NEXT 


CURRENT or * _ 


DIRECT I1ON—-—DOWN 
-sack-] 
—UP 


L-SUPPRESS ION—name | 


COLOR—colorname 


t-HIG 


RGB—rvalue—gvalue—bvalue 


HLIGHT—hvalue 


-_COVERAGE—cvalue | 


BLACK—bvalue | 


CMY K—cvalue—mvalue—yvalue—kvalue 


CIELAB 


lvalue 


clvalue— c2value-—————_ 
Lo eee 


BARCODE 


name | 


TYPE 


n 
I-CODE39 (same as 1)——+ 
L-MSI (same as 2)————+ 
t-UPCA (same as 3) 
L-UPCE (same as 5) 
L-UPC2SUPP (same as 6)— 
L-UPC5SUPP (same as 7)—4 
L-EAN8 (same as 8) 
LEAN13 (same as 9)———+ 
L-IND20F5 (same as 10)—4 
L-MAT20F5 (same as 11)—4 
t-ITL20F5 (same as 12)—4 
L-CDB20F7 (same as 13)—4 
--CODE128 (same as 17)—J 

( 

( 


L-EAN2SUP (same as 22)—4 
L-EAN5SUP (same as 23)—4 
L-POSTNET (same as 24)— 
L-RM4SCC (same as 26)——+ 
L-JPOSTAL (same as 27)—4 
L-2DMATRIX (same as 28)— 
L-2DMAXI (same as 29)——+ 
--2DPDF417 (same as 30)— 
_APOSTAL (same as 31)— 
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BARCODE Parameters: 


MOD—n | HRI ON SSASTERISK: ON HEIGHT—n 
ABOVE HRIFONT—fontname Lorr IN 
BELOW. MM 
OFF: CM 
ONLY POINTS 
L-PELS—} 
>. 
MODWIDTH—n BCCOLOR colorname SUPPBLANKS—! L_RAT I0— ae! 
BLUE 
RED 
L-MAGENTA or PINK: 
GREEN 
L-CYAN or TURQ 
t-YELLOW. 
BLACK: 
BROWN 
MUSTARD: 
DARKBLUE 
L-DARKGREEN: 
L-DARKTURQ or DARKCYAN— 
ORANGE: 
PURPLE. 
}-GRAY: 
NONE. 
DEFAULT. 
>. 
BCXPARMS 
L size num- rows row-size ID—1—1 | 
MIN BY. SEQUENCE—sqn tot 
Lor _ID—uidHi—uidLo— 
>. 
NOE2A: ESC. MODE—4 SECLV—0 USERDEF- NOZIPPER. | lr] 
E2A. NOESC MODE—and- SECLV—s1 FNC1UCC. ZIPPER | MACRO. qstring. 
FNC1IND: 
RDRPROG 
MAC5: 
-MAC6—— 


The FIELD command identifies a field in a data record or supplies a field of constant text, and positions 
where the field is on the page. More than one position on the page can be specified. 


FIELD commanas: 

¢ Are subordinate to a PRINTLINE command 

¢ Must follow a PRINTLINE command 

* Must contain either a LENGTH subcommand or a TEXT subcommand 


The FONT, DIRECTION, and COLOR subcommands do not have fixed defaults. If any of these 
subcommands is omitted, the value for the omitted subcommand is obtained from corresponding 
subcommand in the PRINTLINE command. 


Subcommands 
START Specifies the starting byte in the data record for the desired field. 
n Specifies the number of bytes from the first data byte in the record to be used as 
the starting point of the field. The first data byte position of an input record is 1. 
Note: The carriage-control character and the table-reference character are not 
considered data. 
* Denotes the next byte after the field identified in the previous FIELD command, 


excluding FIELD commands with constant TEXT. 
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If START * was specified in the previous FIELD command, byte 1 is assumed. 


+n Adds the value of n to the * byte position. 


-n Subtracts the value of n from the * byte position. 


If START is omitted and LENGTH is specified, then START * is assumed. 


Specifies the number (n) of bytes to process from the data record, beginning with the 
position specified in START. 


Specifies the constant text that is to be printed in the output. A maximum of 65,535 bytes 
of text can be provided in one page format. 


Note: This text is considered constant in that the same text is printed each time. In 
reference to the CONSTANT command within a form definition, this text is 
considered variable because the text prints only where variable data is allowed to 


print. 


duplication=Dn 


Specifies the number of times the text is to be repeated (use a decimal 
number). The maximum times the text is repeated varies depending on the 
size of the text. The default is 1. 


texttype = {C|XIGIK} 


L(m) 


"text 


Specifies the type of text. 


C Indicates that the text contains single-byte code characters, which 
includes all Roman alphabetic characters (for example, those used for 
English). Any valid character code can be specified, including blanks. 
This is the default. 


X Indicates that the text contains hexadecimal codes (in groups of two 
hexadecimal codes) that specify values from X'00' through X'FE’. 


G_Indicates that the text contains double-byte code characters (for 
example, kanji characters). 


Characters in type G text must start with shift-out (SO X'0E’) and end 
with shift-in (SI X'OF') characters within opening and closing 
apostrophes (X'7D’). 


K Indicates that the text contains kanji numbers enclosed in apostrophes. 
Kanji numbers are separated by commas: 


K'321,400' 
Valid double-byte character set (DBCS) codes are from X'41' through X'FE' 
for each byte. Code X'4040' (blank) is the only exception. 
Valid X'4040', X'4041', X'41FE' X'FE41', X'FEFE' 
Invalid X'2040', X'413E', X'4100' X'7FOO'”, X'FESE' 


Specifies the length of text (use a decimal number in parentheses). When 
the actual length of the text is different from m, the m specification is 
honored. That is, the text is either padded with blanks to the right or 
truncated. 


Specifies the text. 


Examples: 


¢ When TEXT 2C(8)‘AB’ is specified, ‘AB AB ’ is generated. The blanks 
are generated because of the (3) specification. 
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FONT 


POSITION 


* TEXT 2C(1)‘AB’ generates ‘AA’, truncating the Bs. 
Defines the font to be used for the field. 


name? 
Specifies the local name of a font used to print the data. This font must have been 
defined in a previous FONT command in this page definition. 


If Shift-Out, Shift-ln (SOSI) processing is used, name7 must be the single-byte 
font. 


name2 
Specify only when using Shift-Out, Shift-ln (SOSI) processing to dynamically 
switch between a single-byte font and a double-byte font within the field. name2 
must be the double-byte font. 

Notes: 


1. If this subcommand is not specified, the font specified in the preceding PRINTLINE 
command is used. If neither has been specified, the print server assigns a font. 


2. When selecting a font in AIX or Windows NT, you could consider that the text is 
selected in EBCDIC, not ASCII. Therefore, an EBCDIC font and code page 500 (also 
called International #5) should be used for name7. 


Specifies the starting position of the field in the printout. 
x-pos_ Do not mix x-pos specifications with CURRENT or * except in ACROSS fields. 
- Specifies that the x value is negative. 


Xx Specifies the horizontal offset for the starting print position relative 
to the printline starting position. The choices are IN, MM, CM, 
POINTS, or PELS. 


The default is the most recent SETUNITS command value or IN 
(inch) if a SETUNITS command has not been issued. 


The PELS measurement equals one L-unit or 1/240 of an inch, 
depending on whether the PELSPERINCH parameter had been 
specified previously. 


CURRENT Specifies that the inline offset (relative to the field’s direction) is 
the end of the previous field. For the first field, use the 
PRINTLINE offset. This is the default. 


Note: The meaning of CURRENT differs from the meaning of the 
PRINTLINE| command parameter SAME. 


° Alternate for CURRENT. 
y-pos Do not mix y-pos specifications with CURRENT or * except in ACROSS fields. 
- Specifies that the y value is negative. 


y Specifies the vertical offset for the starting print position relative to 
the printline starting position. The choices are IN, MM, CM, 
POINTS, or PELS. 


The default is the most recent/SETUNITS} command value or IN 


(inch) if a SETUNITS command has not been issued. 


NEXT Specifies a field that is positioned down one line in the baseline 
direction (as defined in the SETUNITS command LINESP 
subcommand) from the previous field. 


Use NEXT only in ACROSS fields. 
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CURRENT Specifies that the baseline offset (relative to the field’s direction) is 
the same as the previous field. That is, the baseline position does 
not change. For the first field, use the PRINTLINE offset. This is 


the default. 
. Alternate for CURRENT. 
DIRECTION _ Specifies the print direction of the field, relative to the upper-left corner as you view the 
logical page. If this subcommand is omitted, the direction specified in the governing 
PRINTLINE| command is used. 
ACROSS The page is printed with the characters added from /eft to right on the 
page, and the lines are added from the top to the bottom. 
DOWN The page is printed with the characters added from top to bottom on the 
page, and the lines added are from the right to the left. 
BACK The page is printed with the characters added from right to left on the 
page, and the lines are added from the bottom to the top. 
UP The page is printed with the characters added from bottom to top on the 
page, and the lines are added from the left to the right. 
Note: Not all printers can print in all directions. Refer to your printer documentation for 
more information. 
SUPPRESSION 
Specifies that this text field can be suppressed (not valid for barcodes). 
name Specifies the name of a field to be suppressed. 
Printing of this field is suppressed if this name is identified by a SUPPRESSION command 
within the form definition. 
The same name can be used in one or more fields to suppress these fields as a group. 
COLOR Specifies an OCA or defined color for the text of this field. This subcommand is 
recognized only by printers that support multiple-color printing. Refer to your printer 
publication for more information. 
colorname Values for colorname are NONE, DEFAULT, BLACK, BLUE, BROWN, 
GREEN, PINK, RED, TURQ (turquoise), YELLOW, ORANGE, PURPLE, 
MUSTARD, GRAY, DARKBLUE, DARKGREEN, DARKTURQ (dark 
turquoise) or a predefined color. The color choices depend on the printer. 
NONE is the color of the medium. DEFAULT is the printer default color. 
Note: In some printer publications, the color turquoise (TURQ) is called 
“cyan”, and the color pink (PINK) is called “magenta.” 
PPFA supports the following synonyms: 
¢ CYAN for TURQ 
¢ DARKCYAN for DARKTURQ 
¢ DBLUE for DARKBLUE 
* DCYAN for DARKTURQ 
¢ DGREEN for DARKGREEN 
* DTURQ for DARKTURQ 
¢ MAGENTA for PINK 
Color Model Specifies the color of print for this field supported in MO:DCA for the Red/Green/Blue color 
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model (RGB), the highlight color space, the Cyan/Magenta/Yellow/Black color model 
(CMYK), and the CIELAB color model. 


FIELD START 1 LENGTH 5 

COLOR BLUE ; 
FIELD START 1 LENGTH 1 

RGB 10 75 30 ; 
FIELD START 1 LENGTH 1 

cmyk 80 10 10 10 ; 
FIELD START 1 LENGTH 2 

CIELAB 80 100 20 ; 
FIELD START 1 LENGTH 2 

highlight 5 ; 
FIELD START 1 LENGTH 2 

highlight 300 COVERAGE 50 BLACK 30 ; 


Figure 100. Color Model Using the FIELD Command 


RGB rvalue gvalue bvalue 
Three RGB integer values are used. The first (rva/ue) represents a value for red, the 
second (gvalue) represents a value for green, and the third (bva/ue) represents a value for 
blue. Each of the three integer values may be specified as a percentage from 0 to 100. 


Note: An RGB specification of 0/0/0 is black. An RGB specification of 100/100/100 is 
white. Any other value is a color somewhere between black and white, depending 
on the output device. 


HIGHLIGHT hvaiue COVERAGE cvalue BLACK bvalue 
Indicates the highlight color model. Highlight colors are device dependent. 


You can use an integer within the range of 0 to 65535 for the hvalue. 


Note: An hvalue of 0 indicates that there is no default value defined; therefore, the default 
color of the presentation device is used. 


COVERAGE indicates the amount of coverage of the highlight color to be used. You can 
use an integer within the range of 0 to 100 for the cvalue. If less than 100 percent is 
specified, the remaining coverage is achieved with the color of the medium. 


Note: Fractional values are ignored. If COVERAGE is not specified, a value of 100 is 
used as a default. 


BLACK indicates the percentage of black to be added to the highlight color. You can use 
an integer within the range of 0 to 100 for the bva/ue. The amount of black shading 
applied depends on the COVERAGE percentage, which is applied first. If less than 100 
percent is specified, the remaining coverage is achieved with black. 


Note: If BLACK is not specified, a value of 0 is used as a default. 


See /|“Color on the IBM Infoprint HiLite Color Post Processor” on page 47/for more 


information. 


CMYK cvalue mvalue yvalue kvalue 
Defines the cyan/magenta/yellow/black color model. Cvalue specifies the cyan value. 
Mvalue specifies the magenta value. Yvalue specifies the yellow value. Kvalue specifies 
the black value. You can use an integer percentage within the range of O to 100 for any of 
the CMYK values. 
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CIELAB Lvalue (-)c1value (-)c2value 


BARCODE 


Defines the CIELAB model. Use a range of 0.00 to 100.00 with Lvalue to specify the 
luminance value. Use signed integers from -—127 to 127 with c1value and c2value to 
specify the chrominance differences. 


Lvalue, c1value, c2value must be specified in this order. There are no defaults for the 
subvalues. 


Note: Do not specify both an OCA color with the COLOR subparameter and an extended 
color model on the same FIELD or PRINTLINE command. The output is device 
dependent and may not be what you expect. 


Specifies a bar code in a page definition. 


The bar code name can be 1-8 characters long. Refer to your printer documentation for 
additional information about bar code support. Ensure that the bar code fits on the page or 
you will get errors at print time. 


Please read your printer hardware documentation before using bar codes. The 
documentation indicates which bar code types, modifiers, MODWIDTH, element heights, 
and ratio values are valid for the printer. 


PPFA does minimal verification of the bar code values. If you use the MOD, HEIGHT, 
MODWIDTH, and RATIO parameters, ensure that the values you specify are valid for your 
printer. 


For printer optimization, specify BARCODE name options in the first instance of a specific 
type of bar code. If this type is used again, position it as usual with START, LENGTH, and 
POSITION, but specify the barcode information using only BARCODE 
same-name-as-previously. The BARCODE subcommand is recognized only by printers 
that support BCOCA bar code printing; refer to /BM Printing Systems: Printer Information, 
(G544-3290) for more information. 


Note: If you want to suppress blanks, use the SUPPBLANKS parameter. 


For more information about bar codes, see|Appendix D, “More About Bar Code 


Parameters” on page 395] and refer to Data Stream and Object Architectures: Bar Code 


Object Content Architecture Reference, S544-3766. 


name 
Specifies a specific bar code name to be included in a page definition. 


TYPE { 11 type-name } 
Specifies the type of bar code symbol to be generated. 


Note: If a type indicates “(same as n)”, you may substitute the number given for the 
character name. 
The following bar code types are supported: 
type-name 
Specifies a specific bar code type name to be included in a page definition. 


CODE39 (same as 1) 
Specifies a bar code type of Code 39 (3-of-9 code), Automatic Identification 
Manufacturers Uniform Symbol Specification 39. 


MSI (same as 2) 
Specifies a bar code type of modified Plessey code. 


UPCA (same as 3) 
Specifies a bar code type of Universal Product Code (United States) and the 
Canadian Grocery Product Code, Version A 
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UPCE (same as 5) 
Specifies a bar code type of Universal Product Code (United States) and the 
Canadian Grocery Product Code, Version E 


UPC2SUPP (same as 6) 
Specifies a bar code type of Universal Product Code (United States) two-digit 
Supplemental (periodicals). 


UPC5SUPP (same as 7) 
Specifies a bar code type of Universal Product Code (United States) five-digit 
Supplemental (paperbacks). 


EANS8 (same as 8) 
Specifies a bar code type of European Article Numbering 8 (includes 
Japanese Article Numbering-short). 


EAN13 (same as 9) 
Specifies a bar code type of European Article Numbering 13 (includes 
Japanese Article Numbering-standard). 


IND2OF5 (same as 10) 
Specifies a bar code type of Industrial 2-of-5. 


MAT2OF5 (same as 11) 
Specifies a bar code type of Matrix 2-of-5. 


ITL2OF5 (same as 12) 
Specifies a bar code type of Interleaved 2-of-5, Automatic Identification 
Manufacturers Uniform Symbol Specification-| 2/5. 


CDB20F7 (same as 13) 
Specifies a bar code type of Codabar, 2-of-7, Automatic Identification 
Manufacturers Uniform Symbol Specification-Codabar. 


CODE128 (same as 17) 
Specifies a bar code type of Code 128, Automatic Identification Manufacturers 
Uniform Symbol Specification-128. 


Note: There is a subset of CODE128 called EAN128. These EAN128 bar 
codes can be produced with PPFA by specifying CODE128 for the bar 
code type in the PAGEDEF and including the “extra” parts of the bar 
code in the data. The UCC-128 bar code format is: 


startcode FNC1 ai nnnnnnnnnnnnnnnnnn m c stopchar 


The string of ns represents the bar code data. The start code, stop 
character, and 'c' value are generated by the printer microcode for 
BCOCA bar codes. The FNC1 is a hexadecimal 8F character. The “ai” 
is an application identifier and needs to be defined for use by each 
EAN128 application. The “m” is a modulo 10 check digit that must be 
calculated by the application and included in the bar code data. 


Not all IBM printers generate the EAN128 bar codes, thus you may 
need to verify that the bar code produced in this manner is readable by 
your bar code scanner. 


For more information about the EAN128 bar codes, visit the Uniform 
Code Council WEB site at http: //www.UC-council.org. 


EAN2SUP (same as 22) 
Specifies a bar code type of European Article Numbering, Two-digit 
Supplemental. 
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EAN5SUB (same as 23) 
Specifies a bar code type of European Article Numbering, Five-digit 
Supplemental. 


POSTNET (same as 24) 
Specifies a bar code type of POSTal Numeric Encoding Technique (United 
States Postal Service), and defines specific values for the BSD module width, 
element height, height multiplier, and wide-to-narrow ratio fields. 


RM4SCC (same as 26) 
Specifies a 4-state customer code defined by the Royal Mail Postal Service of 
England for bar coding postal code information. 


JPOSTAL (same as 27) 
A complete Japan Postal Bar Code symbol consists of a set of distinct bars 
and spaces for each character followed by a modulo 19 checksum character 
and enclosed by a unique start character, stop character and quiet zones. 


2DMATRIX (same as 28) 
Specifies a Data Matrix two-dimensional bar code. Two-dimensional matrix 
symbologies (sometimes called area symbologies) allow large amounts of 
information to be encoded in a two-dimensional matrix. These symbologies are 
usually rectangular and require a quiet zone around all four sides; for 
example, the Data Matrix symbology requires a quiet zone at least one 
module wide around the symbol. Two-dimensional matrix symbologies use 
extensive data compaction and error correction codes, allowing large amounts 
of character or binary data to be encoded. 


2DMAXI (same as 29) 
Specifies a MaxiCode two-dimensional stacked bar code. Two-dimensional 
stacked symbologies allow large amounts of information to be encoded by 
effectively stacking short one-dimensional symbols in a row/column 
arrangement. This reduces the amount of space that is typically consumed by 
conventional linear bar code symbols and allows for a large variety of 
rectangular bar code shapes. 


2DPDF417 (same as 30) 
Specifies a PDF417 two-dimensional stacked bar code. Two-dimensional 
stacked symbologies allow large amounts of information to be encoded by 
effectively stacking short one-dimensional symbols in a row/column 
arrangement. This reduces the amount of space that is typically consumed by 
conventional linear bar code symbols and allows for a large variety of 
rectangular bar code shapes. 


APOSTAL (same as 31) 
Specifies the barcode type as defined by the Australian Postal Service. 


MOD 


Specifies additional processing information about the bar code symbol to be generated 
(for example, MOD specifies whether a check-digit '' should be generated for the bar 
code symbol). 


n The made of n differs between the types. For more information, see|Table 30 


on page 402 


11. Check digits are a method of verifying data integrity during the bar code reading process. 
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If MOD is not specified, the MOD value defaults as follows, depending on the bar code 
type specified: 


TYPE M 
13 
17 
22 
23 
24 
26 
27 
28 
29 
30 
31 


i] 


TYPE M 


o 


a Coo ooo mol a ie) 
=-=C0CCODDCCON=AO 


HRI 
Specifies the human-readable interpretation (text characters) to be generated and 
placed above or below the bar code symbol, as directed. 


ON Specifies that HRI should be generated at the default location for the barcode 
type. 

ABOVE 
Specifies that HRI should be placed above the bar code symbol. 


BELOW 
Specifies that HRI should be placed below the bar code symbol. 


OFF Specifies that HRI should not be generated. 


ONLY Specifies that only the HRI is to be printed. No barcode symbol is to be 
generated. The POSITION parameters on the FIELD command specify the 
placement position for the first character of the HRI. 


Note: Not all barcode printers honor the request to suppress printing the 
barcode symbol. 


Note: If HRI is requested, and HRI font isn’t, the printer default font is used to render 
the HRI, instead of the font specified on the FIELD FONT subcommand. 


HRIFONT fonitname 
Specifies the local name of a font used in printing the HRI for the barcode. This font 
must first be defined in a previous FONT command in the page definition. 


SSASTERISK 
Specifies whether an asterisk is to be generated as the HRI for CODE39 bar code 
start and stop characters. 


Note: SSASTERISK is ignored by all bar code types except CODE39. 


ON 
Specifies that start and stop characters should be generated in the HRI. 


OFF 
Specifies that start and stop characters should not be generated in the HRI. 


HEIGHT 
Specifies the height of bar code element. For UPC and EAN bar codes, the total 
height includes the bar code and the HRI characters. 
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If HEIGHT is not specified, the printer default height is used. 


Note: HEIGHT is ignored by bar code types that explicitly specify the element heights 
(for example, POSTNET or RM4SCC). 


n_ Specifies the height of the bar code. 
unit 


Specifies a unit of measurement for the HEIGHT parameter. The choices are IN, 
MM, CM, POINTS, or PELS. 


Note: If no unit is specified, the default is the most recent}SETUNITS| command 
value or IN (inch) if a SETUNITS command has not been issued. 


MODWIDTH 
Specifies the width of the smallest defined bar code element, using mils (thousandths 
of an inch). For bar code types that explicitly specify the module width (for example, 
POSTNET and RM4SCC), this field is ignored. The range of values allowed is 1-254. 
If MODWIDTH is not specified, the printer default MODWIDTH is used. 


n Specifies the width of each module, using thousandths of an inch (1/1000) as the 
unit of measurement. 


BCOLOR 
Specifies an OCA or defined OCA color to be used in printing the barcode and its 
HRI. 


cname Specifies the name of a defined color. 


SUPPBLANKS 
Suppress the trailing blanks in the data field used to generate the barcode. 


When the page definition selects any of the EAN, UPC or Postnet bar code types and 
modifiers and have also requested that trailing blanks be truncated for the bar code 
field, the print server examines the resulting data length and choose the correct bar 
code type and modifier for the bar code object created. 


Note: If the data length does not match any of the bar code type and modifier 
combinations, the print server uses the original bar code type and modifier 
requested to build the bar code object. 


RATIO 
Specifies the ratio between the width of the wide and the narrow bar code elements. 
The range of values allowed is 100-500, but you must specify a value appropriate for 
your printer and bar code type or you will get errors at print time. 


If RATIO is not specified, the printer default ratio is used. 


n_ The RATIO is specified as a percent value. For example, form nnn. For example, 
200 represents a ratio of 2 to 1; 250 represents a ratio of 2.5 to 1. For most bar 
code symbols, the RATIO value should be between 200 and 300. For bar code 
types that explicitly specify the module width (for example, POSTNET and 
RMA4SCC, this field is ignored. If RATIO is not specified, the default ratio for the 
bar code symbol is used. 


BCXPARMS 
These barcode parameters are for two-dimensional barcode types. 


Note: See the Bar Code Object Content Architecture (BCOCA) Reference, 
S544-3766 for more details on these extra parameters. 
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SIZE 


The size of the two-dimensional barcode. The number of rows and size of the 

rows. The allowable values for rows and rowsize are barcode type dependent. For 

Data Matrix two-dimensional Barcode there are square symbols ranging from 10 

by 10 to 144 by 144 and rectangular symbols ranging from 8 by 18 to 16 by 48 

(rows by row size). See the Bar Code Object Content Architecture (BCOCA) 

Reference, S544—3766 for specific allowable sizes. For PDF417 two-dimensional 

Barcode there can be 3 to 90 rows and 1 to 30 characters per row (row size), but 

their product cannot exceed 928. If size is not coded the default is by type: 

¢ Data Matrix — Marked as unspecified and the appropriate number of rows and 
row-size are used based on the amount of data. 

¢ MaxiCode — Size is not applicable. 

¢ PDF417 — MIN number of rows and 10 data symbols per row (row-size). 


num-rows 
The desired number of rows. 


MIN ~The minimum number of rows necessary to place the symbol (for PDF417 
only). 


row-size 
The number of data characters in a row. For Data Matrix this includes the 
finder pattern. 


SEQUENCE 


Structured append sequence indicator. Some two-dimensional barcodes can be 
logically linked together to encode large amounts of data. The logically linked 
symbols can be presented on the same or different media and are logically 
recombined after they are scanned. PPFA checks the numbers for obvious errors 
as well as the proper number range. For example, SEQUENCE 5 OF 3 is 
obviously wrong. 


sqn 
Structured-append sequence indicator. This parameter is an integer whose 
acceptable range of values is dependent on the barcode type. For 2DMATRIX 
the range is 1 to 16, for 2DMAXI it is 1 to 8. For other barcode types the 
parameter is ignored. 


OF 
Optional parameter for readability. 


tot Total number of structured-append symbols. This parameter is an integer 
whose acceptable range of values is dependent on the barcode type. For 
2DMATRIX the range is 2 to 16, for 2DMAXI it is 2 to 8. For other barcode 
types the parameter is ignored. 


ID uidHi uidLo 


The high and low order bytes of a unique file identification for a set of 
structured-append symbols. Each is a unique number between 1 and 254 and 
identifies this set of symbols. The actual File ID is computed by 256 times UidHi 
plus uidLo. 


Note: ID, uidHi, and uidLo are required for the Data Matrix two-dimensional 
barcode, is optional for MaxiCode, and ignored for PDF417. 


E2A 


EBCDIC to ASCII translation (used for Data Matrix, MaxiCode, and PDF417 
two-dimensional barcodes). For Data Matrix and MaxiCode the printer converts 
each byte of the data from EBCDIC codepage 500 to ASCII codepage 819. 
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For PDF417 the printer converts each byte of the barcode data and each byte of 
the Macro PDF417 control block data from a subset of EBCDIC codepage 500 
into ASCII. This translation covers 181 code points which includes alphanumerics 
and many symbols. The code points that are not covered by the translation do not 
occur in EBCDIC and are mapped, by the printer, to the X'7F' (127) code point. 
Do not use the following EBCDIC code points for PDF417: 


Table 8. EBCDIC Code Points not used with the E2A Command 


x'04' 
X'1A' 
X'29' 
X'35' 
X'62' 
X'6E' 
X'77' 
X'AC' 
X'BC' 
X'ED' 


Table 
X'80' 
X'88' 
X'90' 
X'98' 
X'A6' 
X'B8' 
X'CB' 
X'DD' 


X'06' 
X'1B' 
X'2A' 
X'36' 
X'64' 
X'6F' 
X'78' 
X'AD' 
X'BD' 
X'EE' 


9. ASCII Code 
X'81' 
X'89' 
x'91' 
x'99' 
X'A7' 
X'BE' 
X'CC' 
X'DE' 


X'08' X'09' X'0A' X'14' X'15' X'17' 
X'20' X'21' X'22' X'23' xX'24' X'28' 
X'2B' X'2C' X'30' X'31' X'33' X'34' 
X'38' X'39' X'3A' X'3B' X'3E' X'46' 
X'65' X'66' X'6A' X'6B' X'6C' X'6D' 
X'70' X'72' X'73' X'74' X'75' X'76' 
X'80' X'8C' X'8D' X'8E' X'9D' X'9F' 
X'AE' X'AF' X'B4' X'BS' X'B6' X'B9' 
X'BE' X'BF' X'CA' X'CF' X'DA' X'EB' 
X'EF' X'FA' X'FB' X'FD' X'FE' X'FF' 


Note: If you choose this option, have PDF417 Macro data, and are running on an 
ASCII platform (AIX, Windows NT, or Windows 2000), your PDF417 Macro 
data is already in ASCII, but the E2A command signals the printer to 
convert the data. A problem occurs because the PDF417 Macro data you 
code is ASCII, the line data is EBCDIC, and the printer cannot tell the 
difference. To avoid this problem, PPFA converts the macro data to 
EBCDIC codepage 500 by treating the ASCII platform as codepage 819. If 
any of the data code points map to the code points in PPFA issues 
an error message and does not generate a page definition. Do not use the 
code points in\Table 9| when coding a PDF417 Macro and generating a 
page definition on an ASCII platform while translating EBCDIC to 


ASCII (E2A): 
Points not used with the E2A Command 

X'82' X'83' X'84' X'85' X'86' X'87' 
X'8A' X'8B' X'8C' X'8D' X'8E' X'8F' 
x'g2' X'93' x'94' X'95' X'96' X'97' 
X'QA' X'9B' X'9C' X'9D' X'9E' X'A4' 
X'A8' X'Ag' X'AE' X'AF' X'B4' X'B6' 
X'CO' X'C1' xX'C2' X'C3' X'C8' X'CA' 
X'CD' X'CE' X'CF' X'DO' X'D7' X'D8' 
X'E3' X'FO' X'F8' X'FD' X'FE' 


NOE2A 
No translation. (This is the default if neither is coded. This parameter is used for 
Data Matrix, MaxiCode, and PDF417 two-dimensional barcodes). No translation is 
done by the printer or PPFA. The bar code data is assumed to be the default 
encodation (GL10) as defined in the AIM Uniform Symbology Specification for 
PDF417. 


ESC 

~ Escape Sequence Handling. This is the default if neither is coded (used for Data 
Matrix, MaxiCode, and PDF417 two-dimensional barcodes). Each backslash 
character within the bar code data is treated as a normal data character. Note that 
in this case no code page switching can occur within the data. 


NOESC 
Ignore Escape Sequences (used for Data Matrix, MaxiCode, and PDF417 
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two-dimensional barcodes). Each backslash character within the bar code data is 
treated as an escape character. No code page switching can occur within the 
data. 


Note: If the EBCDIC to ASCII flag is set (E2A), all EBCDIC backslash characters 
(X'E0') are converted to ASCII (X'5C') before the ESC sequence handling 
flag is applied. 


MODE 
Symbol mode (used for MaxiCode two-dimensional barcode only). If not coded, 
the default is Standard Symbol Mode 4. 


2 ~ Structured Carrier Message — numeric postal code 

3 Structured Carrier Message — alphanumeric postal code 

4 Standard symbol (default) 

5 not supported 

6 The bar code data is used to program the bar code reader system. 


SECLEV 
This parameter specifies the desired security level for the symbol as a value from 
0 to 8. Each higher security level causes more error correction codewords to be 
added to the symbol (used for PDF417 two-dimensional barcode only). If not 
coded, the default is Security level 0. 


Data Matrix Special Functions 
These are special functions which can only be used with a Data Matrix symbol. If 
not coded, the default is USERDEF (user defined symbol). 


FNC1UCC UCC/EAN1 alternate data type identifier. A FNC1 is added in the 
first data position (or fifth position of a structured append symbol) 
to indicate that this bar code symbol conforms to the USS/EAC 
application identifier standard format. 


FNC1IND Industry FNC1 alternate data type identifier. An FNC1 is added in 
the second data position (or sixth data position of a structured 
append symbol) to indicate that this bar code symbol conforms to 
a particular industry standard format. 


RDRPROG Use this when the symbol contains a message used to program 
the barcode reader. In this case the barcode symbol cannot be a 
part of a structured append sequence. 


MAC5 This provides instructions to the bar code reader to insert an 
industry specific header and trailer around the symbol data. The 
bar code symbol contains a 05 Macro codeword. The barcode 
symbol cannot be a part of a structured append sequence. 


MAC6 Same as MAC5 except the bar code symbol contains a 06 Macro 
codeword. The barcode symbol cannot be a part of a structured 
append sequence. 


USERDEF None of the above. This is a user defined data symbol with no 
Header or Trailer instructions to the reader. 


Zipper Pattern 
Print a zipper pattern and contrast block (use for MaxiCode two-dimensional 
barcode only) 


NOZIPPER 
Does not print a zipper pattern (default). 
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Prints a zipper pattern. 


PDF417 Macro data. The total length of macro text is limited to 2,710 bytes. This 
is the maximum number of symbols that can be displayed using PDF417 
symbology and all numbers in the data. This does not guarantee that the macro 
text is not too long if the macro contains other than numeric data, characters, or 
binary data, for example. 


qstring A quoted string. The string does not extend across records, but 


you can code multiple quoted strings. Code the MACRO keyword 
only once. 


Note: The following is a summary of the allowable Barcode Extra Parameters by barcode 
type. Inappropriate parameters are ignored. 
Two-dimensional Data Matrix allows: 


E2AINOE2A 

ESCINOESC 

SIZE num-rows BY row-size (see Bar Code Object Content Architecture 
Reference for allowable sizes) 

SEQUENCE sqn OF tot ID uidHi uidLo (where sqn can be 1 through 16, tot 
can be 2 through 16, and uidHi and uidLo can be 1 through 254) 

Data Matrix Special Functions 


Two-dimensional MaxiCode 


E2AINOE2A 

ESCINOESC 

MODE md (where md is 2 through 6) 

SEQUENCE sqn OF fot (where sqn can be 1 through 8 and fot can be 2 
through 8) 

NOZIPPERIZIPPER 


Two-dimensional PDF417 


E2AINOE2A 

ESCINOESC 

SIZE num-rows BY row-size (num-rows can be 1 to 30 and row-size can be 3 
to 90) 

SECLEV s/ (s/ can be 0 through 8) 

MACRO ‘macro-text’ ‘more-macro-text’ 
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FONT Command 


cae 
>>—FONT c fname > 
Lame! | pecs POINTS 

t-Lname—'cfname ' HEIGHT—n 
t-Lname—CS—character set name—CP—code page name— IN 
'—_Iname—GRID—hex grid CM 

MM 

L-PELS—— 
TYPE—EBCDIC --ROTATION—O: 


UNICODE [-18 
270 


eT I Lpatto—percen a ee Lay 
0 


| 


300 | WETTECH—-F1xe0—_ 
RELATIVE 


The FONT command is used to identify the fonts that are to be specified in the PRINTLINE, FIELD, and 
TRCREF commands. A maximum of 127 font names for each page definition can be identified. 


Note: Naming a font with the FONT command does not, by itself, affect your output. You must specify the 
font in a PRINTLINE, FIELD, or TRCREF command for the font to become effective. If you do not 
name a font, the default font is used. 


FONT commands immediately follow the PAGEDEF command. A separate FONT command is required: 
* For each font used within a page definition 
¢ For each rotation of the same font 


Note: See the|TRCREF|command for the exception. 
FONT Identifies the fonts to be specified in the|PRINTLINE| |FIELD| and|/TRCREF| commands. 


Iname Local name for the font. Specifies an unquoted alphanumeric name of 1 to 
16 characters (local name) of the font to be used in this page definition. 
The name must conform to the token rules and must be unique within this 
page definition. 


Iname is used in the PRINTLINE, FIELD, or TRCREF commands of a 
page definition. 


Iname is optional if cfname is specified. 


cfname Coded font name. Specifies an alphanumeric name of 1 to 6 characters 
(user-access name) of the coded font to be used in this page definition. 
Specify this name without the Xn prefix. 


'cfname' Quoted full user-access name. Specifies a quoted alphanumeric name of 
1 to 8 characters of the coded font to be used in this page definition. The 
name can contain blanks and special characters. No upper case folding or 
prefix is added to the name. The 'cfname' variable is intended for outline 
fonts and allows them to be selected without overriding the HEIGHT 
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specified in the CFI structured field in the coded font. Enter the full outline 
font name as a quoted name and do not enter the HEIGHT parameter. For 
example, if you enter: 


FONT myfont 'XZM32F' 


the outline font XZM32F is used with no overriding HEIGHT parameters 
used. 


Notes: 


1. The quoted name of the font name is primarily intended for outline 
fonts. If you use a quoted name for a raster font, you must be sure 
that you have the name corresponding to the correct rotation of the 
font. 


2. If you use the quoted name of the font name, you must also enter an 
Iname (local name); sometimes called an “alias name”. 


3. You can still specify the HEIGHT command if you want and override 
the coded font height. 


character-set-name 
Specifies an alphanumeric name of 1 to 6 characters of the character set 
to be used in this page definition. Specify this name without the Cn prefix. 


code-page-name 
Specifies an alphanumeric name of 1 to 6 characters of the code page 
without the T1 prefix to be used in this page definition. 


hex-grid Specifies the 16-character hexadecimal GRID. 


Subcommands 
SBCS or DBCS 


HEIGHT n 


TYPE 


RATIO 


Specifies single-byte or double-byte fonts. 
SBCS Specifies that the font is a single-byte character set. This is the default. 
DBCS Specifies that the font is a double-byte character set. 


Specifies the height of the outline font. 


POINTS Each point is equal to 1/72 of one inch. 

IN Inches 

CM Centimeters 

MM Millimeters 

PELS Pels in the current Logical Units per inch. For example in 240ths of an 
inch. 


The TYPE subcommand indicates the type of font being used. 


EBCDIC This parameter is normally used for fonts on OS390-based systems. This 
is the default. 


ASCII This parameter is normally used for fonts on workstation—based systems. 
UNICODE This parameter is used with Unicode type fonts. 
Specifies the ratio of scaling the width relative to the height in an outline font. 


percent Represents the percent of the “normal” width of the character that is 
printed. For example, specifying RATIO 50 yields a font with characters 
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half as wide as normal, and specifying RATIO 200 yields a font with 
characters twice as wide (200% as wide) as normal. If RATIO is specified, 
you must also specify the HEIGHT. 


ROTATION Specifies the rotation of characters in degrees. The specified value is relative to the inline 
direction of a printline or field. Valid rotations are 0°, 90°, 180°, or 270°; 0° is the default. 


RESOLUTION Specifies the resolution and metric technology on a font. Examples of resolution command 
inputs are: 


RES or RESOLUTION 
The raster-pattern resolution units in pels per inch 
240 240 pels per inch 
300 300 pels per inch 
METTECH or METRICTECHNOLOGY 
The metric technology used for this raster font 
FIXED Fixed-metric technology 
RELATIVE Relative-metric technology 
Notes: 


1. The resolution and metrictechnology subcommands allow rigorous font specifications 
for use with font fidelity. See the font fidelity subcommand FONTFID on the FORMDEF 
command. 


2. Fora description of metric technologies, refer to: 
¢ Intelligent Printer Data Stream Reference, S544-3417 
* Font Object Content Architecture Reference, S544-3285 


3. RESOLUTION can be abbreviated as RES; METRICTECHNOLOGY can be 
abbreviated as METTECH. 


FORMDEF xmpQ1 
FONTFID YES ; 


PAGEDEF xmp01 replace yes ; 
FONT xx2 res 240 mettech fixed ; 
PRINTLINE font xx2 ; 


Figure 101. Example of PPFA Support for Font Fidelity 


In|Figure 101} the form definition xmp01 specifies font fidelity and the page definition 
specifies a font that has 240 pels per inch resolution and fixed-metric technology. If a font 


with exactly those characteristics is not accessible by the printer, an error occurs and 
processing stops. 
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OBJECT Command 


OBNOKEEP. 
>>—0BJECT—internal -name—OBXNAME- X=name: OBTYPE- PSEG > 


L_'x-name d I0CA: CMY KSWOP. --NOPRELOAD. 
}-BCOCA “cmMyYKEURO— Loskees—f 
GOCA: _PRELOAD: 
LOTHER - OB1D—~—component- id. 
-type-name- 


NOPRELOAD- 


_QB2RESOURCE. OB2XNAME- Secondary-x-name. OB2 1D. n 
-secondary- internal -name: Li secondary=x-iiane od Le jpe2nanes LPRELOAD——' 

t-'secondary-internal-name' 

LTEXTTYPE—'secondary-internal-name '— 


The OBJECT command allows you to define an external object to PPFA. Then you can use the 
PRINTLINE command with the OBJECT subcommand to place the defined object on a page. 


You can use one PRINTLINE command to place one or many defined objects multiple times with different 
placement parameters on each placement. On the PRINTLINE OBJECT subcommand, enter information 
about the positioning, rotation, color, object size, and mapping instructions. All positioning is relative to the 
print line coordinate system. The internal-name appears on both the OBJECT command and on the 
PRINTLINE OBJECT subcommand, and is used similar to the way overlays and page segments are 
defined and placed (or printed). 


Notes: 


1. The internal-name is case insensitive but, other than that, the internal-name of the OBJECT command 
and of the PRINTLINE OBJECT subcommand must match exactly. 


2. This function requires both the print server and printer support. Check your print server and printer 
documentation. 


OBJECT internal-name 
Identifies the object and also is used to match a PRINTLINE OBJECT subcommand. The 
internal-name can be no more than 16 alphanumeric characters. 


Subcommands 


OBXNAME x-name 
Specifies the external name of the resource object, which indicates where the object is 
located. For example, in OS/390, the x-name is the member name of the object in the 
object library. No prefixes are assumed on the name. 


The x-name can be no more than 8 alphanumeric characters. If your operating system is 
AIX or Windows, the x-name is translated to EBCDIC. 


Note: Items within quotation marks are not translated to uppercase or to their EBCDIC 
code equivalent. 


OBTYPE Used to specify the type of the object. Observe that each of the object types restricts the 
type of mapping option allowed in the placement of the object (OBMAP on the OBJECT 
subcommand on the PRINTLINE command). 


PSEG Specifies a page segment object, as described in the Mixed Object 
Document Content Architecture (MODCA) Reference Manual, 
(SC31-6802). All mapping types (OBMAP) are allowed by PPFA; however, 
the print server issues an error if any of the objects contained in the page 
segment is not compatible with the coded OBMAP parameter. 
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GOCA 


BCOCA 


IOCA 


OTHER 


OBID 


Specifies a graphics object, as described in the Graphics Object Content 
Architecture (GOCA) Reference Manual, (SC31-6804). GOCA allows you 
to specify TRIM, FIT, CENTER, REPEAT, and FILL parameters on the 
OBMAP subcommand. 


Specifies a bar code object, as described in the Bar Code Object Content 
Architecture (BCOCA) Reference Manual, (S544-3766). BCOCA allows 
you to specify only the LEFT parameter on the OBMAP subcommand. 


Specifies a image object, as described in the Image Object Content 
Architecture (IOCA) Reference Manual, (SC31-6805). The IOCA object 
type allows you to specify TRIM, FIT, CENTER, REPEAT, and FILL 
parameters on the OBMAP subcommand. 


Specifies other object data. The object data to be included is a paginated 
presentation object with a format that may or may not be defined by an 
IBM presentation architecture. When you specify OTHER, you must also 
specify the OBID parameter. The OTHER object type allows you to specify 
TRIM, FIT, CENTER, REPEAT, and FILL parameters on the OBMAP 
subcommand. 


Specifies either a component identifier or a type name from|Table 10} The 
OBID is translated into an Encoded OID and matched to the OID inside 
the object; they must match. 


component-id Specifies the component identifier. 


type-name Type-name is a name chosen by PPFA as an alternative 
to coding a component identifier. 


Table 10. Non-OCA Objects supported by IOB. 


Type-Name Component-id Description of OBID Object Type 

EPS 13 Encapsulated PostScript 

TIFF 14 Tag Image File Format 

WINDIB 17 Device Dependent Bit Map [DIB], Windows Version 
OS2DIB 18 Device Dependent Bit Map [DIB], PM Version 
PCX 19 Paintbrush Picture File Format 

GIF 22 Graphics Interchange Format 

JFIF 23 JPEG file Interchange Format 

PDFSPO 25 PDF Single Page Object 

PCLPO 34 PCL Page Object 

EPSTR 48 EPS with Transparency 

PDFSPOTR 49 PDF Single Page Object with Transparency 


Table 11. Object Types that can be referenced as Secondary Resources 


Type-Name Component-id Description of OID Type-Name 
PDFRO 26 PDF Resource Object (new) 
RESCLRPRO 46 Resident Color Profile Resource Object 
IOCAFS45RO 47 IOCA FS45 Resource Object Tile (new) 


CMYKSWOP | CMYKEURO 


Indicates the color profile if it is required by the object. 
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This object name is not included in a Map Data Resource structured field making the 
object loadable each time the object is placed on the page. 


This object is included in a Map Data Resource at the beginning of the PAGEDEF making 
a hard object at the beginning of the page and then available throughout without reloading. 
Note that only objects with OBTYPE IOCA and OTHER can be kept. If OBKEEP is coded 
with other than those it is ignored. 


NOPRELOAD | PRELOAD 
If you wish the object to be preloaded prior to the running of this job, 
specify it here. Note that only objects with OBTYPE IOCA and OTHER 
can be preloaded. If PRELOAD is coded with other than those, it is 
ignored. 


OB2RESOURCE secondary-internal-name 


If the primary contains a reference to one or more secondary objects, you must identify 
them at this point. Specify the internal name for the secondary resource as specified in the 
primary resource. If the internal name contains special characters such as periods or 
blanks, then quotes must surround the name, however, keep in mind that items within 
quotation marks are not translated to uppercase or to their EBCDIC code page 500 
equivalent. For example, if this entry is meant for the MVS environment, make sure that 
the entry is in all uppercase. 


Use the form TEXTTYPE secondary-internal-name when specifying names for mixed 
EBCDIC/ASCII usage. TEXTTYPEs can be a blank, “C”, “X”, “A”, or “E” where a blank or 
“C” means no translation, “X” means hexadecimal, “A” means translate to ASCII, if 
necessary, and “E” means translate to EBCDIC, if necessary. See the TEXT command for 
further description of these types. 


All specified secondary resources are kept. 


OB2XNAME 'secondary-x-name’ 


This entry contains the external name for the secondary resource. If the external name 
contains special characters such as periods or blanks, then the name can extend to 100 
characters and quotes must surround the name. However, keep in mind that items within 
quotation marks are not translated to uppercase or to their EBCDIC code page 500 
equivalents. For example, if this entry is meant for the MVS environment, make sure that 
the entry is in all uppercase. 


OB2ID n| type-name 


Component type identifier for secondary resource; use an object type number as specified 


in Object type list adjustments. Use an object type number from the “Component-id” 
column or a type name from the “Type-Name” column of|Table 11 on page 236 


NOPRELOAD | PRELOAD 


If you wish the secondary object to be preloaded prior to the running of this job, specify it 
here. 
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OVERLAY Command 
Belaeal 


| preLoAD— 


>>—OVERLAY—x-name >< 


This OVERLAY command is used to identify the overlay that is positioned on a page at some spot other 
than the position defined within the overlay. This function is similar to the SEGMENT command. A 
separate OVERLAY command is required for each overlay. A maximum of 254 OVERLAY commands 
(each of the 254 names must be unique) can be specified for each page format. 


The OVERLAY commands are nested within the PAGEFORMAT command. 
ITRCREF, 


OVERLAY ] 
[ OVERLAY ] 
For the overlay to be used, the line data must contain an Include Page Overlay (IPO) structured field. The 


same name must appear within the structured field as identified by this command, and the page origin 
must be stated. 


To include page overlays without using the IPO structured field, see the |“PRINTLINE Command 
(Traditional)” on page 244 


OVERLAY Identifies the overlay that is positioned on the page. 
X-name Specifies the user-access name of an overlay to be used with the page 
definition. 
Subcommands 


NOPRELOAD | PRELOAD 
Indicates whether or not the overlay should be preloaded prior to the processing of the job 
or page. 


Note: The prefix ‘O1’ is not part of the six-character user-access name. The overlay name can be 
alphanumeric. 


238  PPFA User's Guide 


PAGEDEF Command (Traditional) 
PAGEDEF Command (Traditional) 


PAGEDEF Command 


--WIDTH— 8.3 — IN _ --HEIGHT— 10.8 — IN | 


>>—PAGEDEF—name | > 
WIDTH—n HEIGHT—n 
; | unit al 
__COMMENT—*-qstring— 
--DIRECT ION—ACROSS REPLACE NO— 
> | 3 >< 
LINEONE—x-pos—y-pos DIRECTION DOWN REPLACE YES— L pELSPERINCH—n— 
Lear 
Uup—~ 


A page definition is a resource used to define how data is to be formatted on a logical page. When 
generated by PPFA, a page definition is stored as a resource in the page-definition library. 


This command must be specified when you define a page definition. All of the PAGEDEF subcommands 
are optional; defaults are assumed. 


Note: Values assigned within the subcommands or the default values become the values for any 
PAGEFORMAT| subcommand not specified. REPLACE is not a PAGEFORMAT subcommand, so 
its default is not carried forward. 


PAGEDEF Identifies the page definition to be used with the print job. 


name Defines an alphanumeric name of 1 to 6 characters for the page definition. When 
page definitions are generated, PPFA assigns the prefix ‘P1’ to this name as the 
external resource name. 


Subcommands 


COMMENT gstring 
Specifies a user comment. This string comment is placed in the NOP structured field of 
the page definition. 


qstring Specifies a quoted set of strings from 1 to 255 characters in total length. 
WIDTH Defines the width of the logical page. 


n A number with up to three decimal places is used. The width may vary according 
to the type of printer being used. For more information, refer to your printer 
documentation. The default is 8.3 IN. 


unit Specifies a unit of measurement for the WIDTH subcommand. The choices are IN, 
MM, CM, POINTS, or PELS. 
Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 
HEIGHT Defines the height of the logical page. 


n A number with up to three decimal places is used. The height may vary according 
to the type of printer being used. For more information, refer to your printer 
documentation. The default is 10.8 IN. 


unit Specifies a unit of measurement for the HEIGHT subcommand. The choices are 
IN, MM, CM, POINTS, and PELS. 
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Note: If no unit is specified, the default is the most recent}|SETUNITS| command 
value or IN (inch) if a SETUNITS command has not been issued. 


LINEONE Specifies the values for the MARGIN and TOP parameters used in the; POSITION 


subcommand of the |PRINTLINE| command. 


X-pos Specifies the offset from the left edge of the logical page (margin position). The 
valid options for x-pos are described in the SETUNITS command for the horizontal 
value. 


Note: If no unit is specified, the default is the most recent}|SETUNITS| command 
value or IN (inch) if a SETUNITS command has not been issued. 


y-pos Specifies the vertical offset from the top of the logical page (top line position). The 
valid options for y-pos are described in the SETUNITS command for the vertical 
value. 


Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 


DIRECTION _ Specifies the print direction of the logical page. Not all printers can print in all print 
directions. For more information, refer to your printer documentation. 


Note: Some printers have a different media origin and require different direction settings 
than most page printers. For printing in the landscape page presentation when 
using wide forms, the PRESENT subcommand must be specified on the FORMDEF 
command to produce readable output. Alternatively, if you have existing page 
definitions, the UP direction can be used in the page definition without changes to 
the form definition to produce the same result. 


ACROSS The page is printed with the characters added /eft to right in each line, and 
the lines added from the top to the bottom. 


DOWN The page is printed with the characters added to the page from top to 
bottom, and the lines added from the right to the left. 


BACK The page is printed with the characters added to the page from right to 
left, and the lines added from the bottom to the top. 


UP The page is printed with the characters added to the page from bottom to 
top, and the lines added from the left to the right. 


REPLACE Specifies whether this page definition is to replace an existing one with the same resource 
name in the library. 


NO This page definition does not replace one with the same resource name in the 
library. 


If a page definition with the same resource name does not exist in the library, this 
page definition is stored. 


YES _ If a page definition with the same resource name already exists in the library, this 
page definition replaces it. 


If a page definition with the same resource name does not exist in the library, this 
page definition is stored. 


PELSPERINCH n 
Specifies the Logical Units in pels per inch for this page definition. Use the 
PELSPERINCH parameter to tell PPFA the pel resolution of your printer to generate more 
exact object placements. 
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n_ Specifies an integer number between 1 and 3,276, which determines the Logical Units 
in pels per inch. 


Note: If the L-Units are not specified on this page definition, they are defaulted to 240 
pels per inch. 


PAGEDEF xmp01 replace yes 
PELSPERINCH 300 ; 


PAGEFORMAT P1 
width 7 in 
height 3 in; 

PRINTLINE; 


PAGEFORMAT P2 
width 7 in 
height 3 in 
PELSPERINCH 1200; 
PRINTLINE; 


Figure 102. PELSPERINCH example 


In the example above, the page definition xmp01 has specified L-Units as 300 pels 
per inch. Because the PAGEFORMAT P1 does not specify L-Units, it inherits 300 
pels per inch. PAGEFORMAT P2 does specify L-Units as 1200 pels per inch. 


The width and height in PAGEFORMAT P1 ( 7 in, 3 in) produces internal and 


structured field values of 2100 and 900, whereas in PAGEFORMAT P2 the same 
code produces values of 8400 and 3600, because of the difference in L-Units. 
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PAGEFORMAT Command 


a 
WIDTH—n HEIGHT—n 


Lnte) | pee 
--DIRECT ION—ACROSS—— 
> 7 >< 
LINEONE—x-pos—y-pos | DIRECTION DOWN PELSPERINCH—n_ 
BACK: 
Lyp—_ 


Page formats are subsets of page definitions. If you want to use more than one set of specifications to 
format a page within a single print job, you must use more than one page format. To change page formats, 
use conditional processing or insert an Invoke Data Map structured field in your print file. (Page formats 
are known to the print server as data maps.) If you do not use conditional processing or if you do not 
insert an Invoke Data Map structured field, the print server uses only the first page format in the page 
definition. Page formats are placed in the page definition in the order in which they are generated. 


PAGEFORMAT subcommands have no fixed defaults. The entire PAGEFORMAT command and all of its 
subcommands can assume defaults. If any PAGEFORMAT subcommand is omitted, its value is selected 
from the corresponding subcommand in the governing]PAGEDEF| command. 


This command can be omitted for the first page format in a page definition if only one page format is used. 
If omitted, PPFA assigns a page format name by using the page-definition name, including the ‘P1’ prefix. 


PAGEFORMAT name 
Specifies an alphanumeric name of 1 to 8 characters. This name must be unique within the page 
definition. 


The following subcommands are used for each page format. They may be issued in the same way 
as in a page definition. Values specified in the PAGEDEF subcommands are used if any of the 
following subcommands are not defined within a page format. 


Subcommands 
WIDTH Defines the width of the logical page. 
n A number with up to three decimal places is used. The width may vary according 
to the type of printer being used. For more information, refer to your printer 


documentation. 
unit Specifies a unit of measurement for the WIDTH subcommand. The choices are IN, 
MM, CM, POINTS, or PELS. 
Note: If no unit is specified, the default is the most recent}|SETUNITS| command 
value or IN (inch) if a SETUNITS command has not been issued. 
HEIGHT Defines the height of the logical page. 


n A number with up to three decimal places is used. The height may vary according 
to the type of printer being used. For more information, refer to your printer 
documentation. 


unit Specifies a unit of measurement for the HEIGHT parameter. The choices are IN, 
MM, CM, POINTS, or PELS. 
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Note: If no unit is specified, the default is the most recent{SETUNITS| command 
value or IN (inch) if a SETUNITS command has not been issued. 


Specifies the values for the MARGIN and TOP parameters used in the POSITION 
subcommand of the PRINTLINE command. 


X-pos_ Specifies the offset from the left edge of the logical page (margin position). The 
valid options for x-pos are described in the SETUNITS command for the horizontal 
value. 


Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 


y-pos Specifies the offset from the top of the logical page (top line position). The valid 
options for y-pos are described in the SETUNITS command for the vertical value. 


Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 


Specifies the print direction of the logical page. Not all printers can print in all print 
directions. For more information, refer to your printer documentation. 


Note: Some printers have a different form origin and require different direction settings 
than most page printers. For printing in the landscape page presentation when 
using wide forms, the PRESENT subcommand must be specified on the FORMDEF 
command to produce readable output. Alternatively, if you have existing page 
definitions, the UP direction can be used in the page definition without changes to 
the form definition to produce the same result. 


ACROSS The page is printed with the characters added to the page from /eft to 
right, and the lines added from the top to the bottom. 


DOWN The page is printed with the characters added to the page from top to 
bottom, and the lines added from the right to the left. 


BACK The page is printed with the characters added to the page from right to 
left, and the lines added from the bottom to the top. 


UP The page is printed with the characters added to the page from bottom to 
top, and the lines added from the left to the right. 


PELSPERINCH n 


Specifies the Logical Units in pels per inch for this page format. Use the PELSPERINCH 
parameter to tell PPFA the pel resolution of your printer to generate more exact object 
placements. 


n_ Specifies an integer number between 1 and 3,276, which determines the Logical Units 
in pels per inch. 


Note: If the L-Units are not specified on the page format, they are inherited from the page 
definition that contains this page format. See|Figure 102 on page 241 
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PRINTLINE Command 


>>—PRINTLINE 


PRINTDATA—YES. 


>< 


FIELD. | CHANNEL—n FONT—name1 PRINTDATA—NO- 
REPEAT—n — named 
LINE 
>. 
POSITION: MARGIN. TOP. 
SAME or = RELATIVE. NEXT. 
Lx-pos SAME or = 
—Y~ pos 
>. 
0—0: OVROTATE—0. 
OVERLAY: Xname ] 
VARIABLE. LENGTH—n: rel. x-pos—rel. y-pos OVROTATE: 90 
Lstart—n 180. 
L270 
a 
>. 
J—0. | Gc DOWN: 
SEGMENT. Xname ] BACK: 
VARIABLE: LENGTH—n. rel. x-pos—rel. y-pos Lyp— 
Lstart—n_] 
>. 
t-COLOR—colorname. 
RGB—rvalue—gvalue—bvalue 
HIGHLIGHT—hvalue 
COVERAGE—cvalue. I | BLACK—bvalue 
/CMYK—cvalue—mvalue—yvalue—kvalue—————________ 
LCIELAB—1 value. clvalue c2value 
Lod Lod 
>. 
O—0. 
OBJECT. internal name: | Other OBJECT Parameters 
LrelX—relY— 
6—O 
VARIABLE: LENGTH—n: [ OBTYPE. PSEG. 
Lstart—n relX—re LY- I0CA 
BCOCA: 
GOCA 
OTHER—OBID. comp-id- 
Ltype-name—] 
Other OBJECT Parameters: 
--OBCHPOS—USEOBJ— 
| 
USEOBJ OBMAP: LEFT. | OBCHPOS—x-pos 
OBSIZE TRIM—— 
wd: | hg | FIT——_J 
unit unit CENTER 
REPEAT— 
FILL—— 
OBCVPOS—USEOBJ OBROTATE—@Q——_ 
> 7 | 
OBCVPOS—y-pos OBROTATE 90 OBCOLOR—color-name 
180 
-270— 
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PRINTLINE The PRINTLINE command specifies the printing of one data record on a line. If a 
formatted printline is to be printed, one or more FIELD commands must follow the 
governing PRINTLINE command; at least one is required. If this is not done, field 
processing is not performed and the unformatted data is printed. 

Subcommands 

REPEAT Specifies the number of printlines that are to be printed on a logical page. The direction 
and font specified within this printline applies to all lines printed. By using this command, 
you do not have to write specifications for each line. 

Note: If the REPEAT subcommand is omitted, only one line is printed for this PRINTLINE 

command. 

n This value specifies the number of printlines for a logical page; the 
maximum value is 65,535. 
REPEAT 0 Not valid 
REPEAT 1 Only one line is printed 
If the CHANNEL or POSITION subcommands are specified within this 
PRINTLINE command, they apply only to the first line. 
If this PRINTLINE is followed by several FIELD commands, the related 
field controls are also repeated. 

FIELD Specifies that fields associated with repetitions of this PRINTLINE are to 
be positioned based on the first instance of the same field. 
This parameter has no affect in fields with the same direction as the 
PRINTLINE of which they are a part. 
This parameter specifies that the direction of repetition—for a given 
field—is the direction of the first instance of this field, plus 90°. Therefore, 
every field of an ACROSS PRINTLINE is repeated down the page, 
regardless of the direction of the FIELD. 

LINE Specifies that fields associated with repetitions of this printline are to be 
positioned based on the repetition of the PRINTLINE itself. 
This parameter has no effect in fields with the same direction as the 
PRINTLINE of which they are a part. 
This parameter specifies that the direction of repetition—for a given 
field—is the direction of the associated PRINTLINE plus 90°. Therefore, 
every field of an ACROSS PRINTLINE is repeated down the page, 
regardless of the direction of the FIELD. 

CHANNEL n_ Used to specify line spacing, skipping within a logical page, or page ejection (skipping to a 
new page). This subcommand is equivalent to the Forms Control Buffer (FCB) channel. 
n_ The range of channels is 1 to 12. These correspond to carriage-control characters in 

the data. There is no default. 

FONT Defines the font to be used for the printline. 


name1 
Specifies the name of_a font used to print the data. This font must have been 
defined in a previous JFONT|command in this page definition. 


If Shift-Out, Shift-ln (SOSI) processing is used, name7 must be the single-byte 
font. 
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PRINTDATA 


name2 
Specify only when using Shift-Out, Shift-ln (SOSI) processing to dynamically 
switch between a single-byte font and a double-byte font within the printline. 
name2 must be the double-byte font. 


Notes: 


1. If this subcommand is not specified and TRC (Table Reference Character) bytes are 
specified in the print data, the print server uses the font indicated by the TRC byte. 
Otherwise, the print server selects a default font. 


2. When selecting a font in AIX, consider that the text is selected in EBCDIC, not ASCII. 
Therefore, an EBCDIC font and code page 500 (also called International #5) should be 
used for name7. 


Specifies whether the line of data associated with the current PRINTLINE should be 
printed. The PRINTDATA subcommand is useful when the data stream is interspersed 
with lines of comments, blank lines, or lines without data that are not meant to be printed. 


YES __ Specifies the data for the current PRINTLINE is printed. YES is the default. 
NO Specifies the data for the current PRINTLINE is not printed. 


Note: Any FIELD command that is associated with a YES command that specifies 
PRINTDATA NO is ignored, and an error message is issued. 


The default position for a YES command that specifies PRINTDATA NO is position same 
same. 


PAGEDEF xmpQ1 ; 


SETUNITS 


PRINTLINE 
PRINTLINE 
PRINTLINE 
PRINTLINE 
PRINTLINE 
PRINTLINE 


LINESP 1 LPI ; 
PrintData NO ; 
PrintData yes ; 


Segment X PrintData NO Overlay Y Position Same Next ; 
PrintData yes 3; 


Figure 103. PRINTLINE NO example 


The LINESP parameter specifies that one line per inch is to be printed. 


af oN 


1. The first line of data is read and printed. 

The second line of data is read, but not printed. 

The third line of data is read and printed one inch down from the first line. 
The fourth line of data is read and printed one inch down from the third line. 
The fifth line of data is read, but not printed. 

* The segment X is printed. 

* The overlay Y is printed. 


6. The sixth line of data is read and printed two inches down from the fourth line. 


POSITION 


Note: The data line 2 was not printed and did not affect the positioning of the lines that 
followed. Line 3 was positioned as though line 2 did not exist. 


Specifies the starting position of the printline in the printout. 


horizontal position 


X-pos Specifies the horizontal offset from the left side of the logical page. The 
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value is a number with up to three decimal places. The valid options for 
X-pos are described in the SETUNITS command for the horizontal value. 


Specifies this line starts at the position specified as the horizontal (x) value 
in the previous |LINEONE| subcommand within this page definition. 


Specifies this line starts at the same horizontal offset position as the 
previous printline. If applied to the first printline of a logical page, the 
horizontal position is 0, which is the default. 


Alternate for SAME. 


Specifies that the following vertical position value is to be processed as a 
relative value. The printline is positioned relative to the last printline placed 
on the page. 


If a set of printlines were skipped over in the page definition because of a 
skip-to-channel carriage control, and the new active printline contains a 
relative vertical position, the output line is positioned relative to the 
location of the last line printed on the page. 


Note: If both TOP and RELATIVE are requested for the Y position value, 
the RELATIVE request is ignored. 


When using RELATIVE positioning, PPFA does not flag 
off-the-page conditions for the position of a printline or for any 
overlays, segments or objects placed relative to that printline. 
Printlines that fall outside the bounds of the logical page are 
flagged by the print server at run time. 


When specifying RELATIVE, use the minus sign to indicate any 
negative values for the PRINTLINE vertical position; you may use 
the plus sign to indicate positive values. If no sign is used, a 
positive value is assumed. 


The DIRECTION for a relative printline must be ACROSS. Fields 
associated with a relative printline must have the same 
DIRECTION as the printline and must match the PAGEFORMAT 
DIRECTION. 


If RELATIVE is specified with “SAME” or “=” as the y value, the 
relative value in the printline is +0. 


Relative positioning is allowed on a PRINTLINE command only if 
the PRINTLINE and all its associated FIELD commands are 
formatted to print in the same direction as the PAGEFORMAT. That 
is, the DIRECTION parameter in the PRINTLINE and any 
associated FIELD commands must specify (or default to) ACROSS. 
The DIRECTION in the PAGEFORMAT or PAGEDEF command 
may be any allowable value: ACROSS, DOWN, BACK, or UP. 


The PRINTLINE command in which relative positioning is used 
must specify a CHANNEL parameter. The n value specified for the 
CHANNEL parameter cannot be used for any other PRINTLINE in 
the same PAGEFORMAT. 

setunits linesp 6 lpi; 

PAGEDEF rel9 replace yes 


direction across width 8.5 in height 11.0 in; 
PRINTLINE channel 1 repeat 7 position 0 IN 1.0 IN; 
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OVERLAY 


248 


vertical position 


y-pos 


TOP 


NEXT 


SAME 


/* The fields will be placed at +120 pels, +24 pels (next) */ 
/* and +48 pels (.20 IN) from lines previously placed on page */ 


setunits linesp 10 Ipi; 

PRINTLINE channel 2 repeat 2 position @ relative next; 
FIELD START 1 LENGTH 3 position 0 IN .5 IN; 
FIELD START 4 LENGTH 3 position 0 IN next; 
FIELD START 7 LENGTH 3 position current .20 IN; 


Specifies the vertical offset from the top side of the logical page. The 
value options for y-pos are described in the SETUNITS command for the 
vertical value. 


Specifies that the printline is placed in the position specified as the vertical 
(y) value in the previous LINEONE subcommand within this page 
definition. 


Specifies the printline is to be positioned down (on the logical page) one 
line (as defined in the LINESP subcommand of the ast STUNTS 
command) from the previous field. The LINESP subcommand of the 
SETUNITS command establishes the distance from one line to the next. 


When NEXT is specified for the first printline of a logical page, the starting 
position of the line is one line down from the top of the logical page, which 
is the default. 


Notes: 


1. The “down” direction is determined by the direction of the logical page 
(as specified in the page format), not the printline direction. NEXT is, 
therefore, mainly useful in ACROSS printlines. 

2. For additional details on this area, please refer to the URL: 
http://www.ibm.com/printers/R5PSC.NSF/Web/ppfaupat 


Specifies this printline starts at the same vertical position as the previous 
printline. 


Alternate for SAME. 


Specifies the name of an overlay that is to be positioned relative to the location specified 


in the PRINTLINE command in which the OVERLAY subcommand was named. The 
PAGEFORMAT OVERLAY command may contain the named overlays. The maximum 
number of overlays specified for a PAGEFORMAT including the PRINTLINE OVERLAY 
subcommand is 254. 


The OVERLAY can be identified by specifying a name (xname) or by getting the name 
from the input data record (use VARIABLE commana). 


Xname 
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The user access name (external name). It can be unquoted or quoted with 
descriptor tags, indicating the data type (for example, ASCII) of the data in 
the field. 


unquoted-name 
An unquoted external name can be up to 6 characters. It 
is folded to upper case, have an “O1” prefix added to it, 
and translated to EBCDIC codepage 500 if necessary. 


quoted-name with no data tag 
A quoted external name can be up to 8 characters. No 
translation is done. It is the data type (EBCDIC or ASCIl) 


SEGMENT 
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as dictated by the system platform. If not 8 bytes long, it is 
padded on the right with EBCDIC or ASCII blanks. 


C'quoted-name' 
This quoted external name can be up to 8 characters. No 
translation is done. It is the data type (EBCDIC or ASCIl) 
as dictated by the system platform. If not 8 bytes long, it is 
padded on the right with EBCDIC or ASCII blanks. 


E'quoted-name' 
This quoted external name can be up to 8 characters. It is 
translated, if necessary, to EBCDIC and padded with 
EBCDIC blanks if it isn’t 8 bytes long. 


A‘quoted-name' 
This quoted external name can be up to 8 characters. It is 
translated, if necessary, to ASCII and padded with ASCII 
blanks if it isn’t 8 bytes long. 


X'hex-digit-pairs' 

This quoted external name can be up to 8 characters (16 
hexadecimal digits). No translation is done. If less than 8 
characters are coded, the name is padded on the right 
with blanks of the platform type where the page definition 
is generated (ASCII on AIX and Windows NT; EBCDIC 
otherwise). The user can avoid the padding by coding all 
16 hexadecimal digits. 


VARIABLE Indicates that the actual name of the overlay, including the O1 prefix, is 
read from the data record. The Variable-Name-Locator field specifies 
where in the data to get the name. 


Note: If you specify VARIABLE for the OVERLAY name and don’t want 
to print the name, then you must have at least one field command, 
or code PRINTDATA NO on the PRINTLINE command. 


START n The starting position in the data record to get the overlay 
name. The first data byte position of the input record is 1. 
If START is not coded, 1 is assumed. 


LENGTH n Length of field. Specifies the number (n) of bytes to 
process from the data record, beginning with the position 
specified in START. The maximum length is 8. 


OVROTATE {019011801270} 
Specifies the rotation of the placed overlay with respect to the x-axis of 
the page. 


See |‘“FORMDEF Command’ on page 185|for an OVROTATE example, 


which is presented in the FORMDEF description. 


Specifies the placement of a segment relative to the location specified in the PRINTLINE 
command in which the SEGMENT subcommand was named. The PAGEFORMAT 
SEGMENT command may contain the named segments. The maximum number of 
segments specified for a PAGEFORMAT including the PRINTLINE SEGMENT 
subcommand is 127. 


The SEGMENT can be identified by specifying a name (Xname) or by getting the name 
from the input data record using VARIABLE Variable-Name-Locator. 
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Xname 


Specifies the user-access name as defined in the SEGMENT command. It can be 
unquoted or quoted with descriptor tags within indicate the data type of the data in 
the field. 


unquoted-name 
An unquoted external name can be up to 6 characters. It is folded 
to upper case, have an “O1” prefix added to it, and be translated 
to EBCDIC codepage 500 if necessary. 


quoted-name with no data tag 
A quoted external name can be up to 8 characters. No translation 
is done. It is the data type (EBCDIC or ASCII) as dictated by the 
system platform. If not 8 bytes long, it is padded on the right with 
EBCDIC or ASCII blanks. 


C'quoted-name' 
A quoted external name can be up to 8 characters. No translation 
is done. It is the data type (EBCDIC or ASCII) as dictated by the 
system platform. If not 8 bytes long, it is padded on the right with 
EBCDIC or ASCII blanks. 


E'quoted-name' 
This quoted external name can be up to 8 characters. It is 
translated, if necessary, to EBCDIC and padded with EBCDIC 
blanks if it isn’t 8 bytes long. 


A'‘quoted-name' 
This quoted external name can be up to 8 characters. It is 
translated, if necessary, to ASCII and padded with ASCII blanks if 
it isn’t 8 bytes long. 


X'hex-digit-pairs' 
This quoted external name can be up to 8 characters (16 
hexadecimal characters). No translation is performed. If less than 
8 characters are coded, the name is padded on the right with 
blanks of the platform type where the page definition was 
generated (ASCII on AIX and NT or EBCDIC otherwise). You can 
avoid the padding by coding all 16 hexadecimal digits. 


VARIABLE 


Indicates that the actual name of the segment, including the S1 prefix, is read 
from the data record. The Variable-Name-Locator field specifies where in the 
data to get the name. 


Note: If you specify VARIABLE for the SEGMENT name and don’t want to print 
the name, then you must have at least one field command, or code 
PRINTDATA NO on the PRINTLINE command. 


START n The starting position in the data record to get the overlay name. 
The first data byte position of the input record is 1. If START is not 
coded, 1 is assumed. 


LENGTH n Length of field. Specifies the number (n) of bytes to process from 
the data record, beginning with the position specified in START. 
The maximum length is 8. 


DIRECTION _ Specifies the print direction of the line relative to the upper-left corner as you view the 
logical page. Not all printers can print in all print directions. For more information about 
your printer, refer to your printer documentation. 
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If DIRECTION is not specified, the direction specified in the |PAGEFORMAT]|command is 
used. Observe that this direction is additive to the direction specified in the PAGEFORMAT 


command. See 


ACROSS 


DOWN 
BACK 


UP 


COLOR colorname 
Specifies an OCA or defined color for the text of this field. This subcommand is recognized 
only by printers that support multiple-color printing. Refer to your printer publication for 
information about the colors that can printed. 


Color Models 


colorname 


The printline direction is rotated 0° relative to the direction specified in the 
PAGEFORMAT (the printlines are oriented in the same direction as the 


page). 


The printline direction is rotated 90° relative to the direction specified in 
the PAGEFORMAT. 


The printline direction is rotated 180° relative to the direction specified in 
the PAGEFORMAT. 


The printline direction is rotated 270° relative to the direction specified in 
the PAGEFORMAT. 


Values for colorname are NONE, DEFAULT, BLACK, BLUE, BROWN, 
GREEN, PINK, RED, TURQ (turquoise), YELLOW, ORANGE, PURPLE, 
MUSTARD, GRAY, DARKBLUE, DARKGREEN, or DARKTURQ (dark 
turquoise). The color choices depend on the printer. 


If you do not enter one of these colors, the default color for that printer is 
used. NONE is the color of the medium. DEFAULT is the printer default 
color. 


Note: In some printer manuals, the color turquoise (TURQ) is called 
“cyan”, and the color pink (PINK) is called “magenta”. 


PPFA supports the following synonyms: 
* CYAN for TURQ 

* DARKCYAN for DARKTURQ 

¢ DBLUE for DARKBLUE 

* DCYAN for DARKTURQ 

* DGREEN for DARKGREEN 

* DTURQ for DARKTURQ 

* MAGENTA for PINK 


Specifies the color of print for this field supported in MO:DCA for the Red/Green/Blue color 
model (RGB), the highlight color space, the Cyan/Magenta/Yellow/Black color model 
(CMYK), and the CIELAB color model. 


RGB rvalue gvalue bvalue 


Three RGB integer values are used. The first (rva/ue) represents a value for red, the 


second (gvalue) represents a value for green, and the third (bva/ue) represents a value for 
blue. Each of the three integer values may be specified as a percentage from 0 to 100. 


Note: An RGB specification of 0/0/0 is black. An RGB specification of 100/100/100 is 
white. Any other value is a color somewhere between black and white, depending 
on the output device. 


HIGHLIGHT hva/ue COVERAGE cvalue BLACK bvalue 
Indicates the highlight color model. Highlight colors are device dependent. 


You can use an integer within the range of 0 to 65535 for the hvalue. 
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hvalue of 0 indicates that there is no default value defined; therefore, the default 


color of the presentation device is used. 


COVERAGE indicates the amount of coverage of the highlight color to be used. You can 


use an int 
specified, 


eger within the range of 0 to 100 for the cvalue. If less than 100 percent is 
the remaining coverage is achieved with the color of the medium. 


Note: Fractional values are ignored. If COVERAGE is not specified, a value of 100 is 
used as a default. 


BLACK indicates the percentage of black to be added to the highlight color. You can use 
an integer within the range of 0 to 100 for the bva/ue. The amount of black shading 
applied depends on the COVERAGE percentage, which is applied first. If less than 100 


percent is 


specified, the remaining coverage is achieved with black. 


Note: If BLACK is not specified, a value of 0 is used as a default. 


See /|“Color on the IBM Infoprint HiLite Color Post Processor” on page 47}for more 


informatio 


CMYK cvalue mvalue yva 


n. 


lue kvalue 


Defines the cyan/magenta/yellow/black color model. Cvalue specifies the cyan value. 
Mvalue specifies the magenta value. Yvalue specifies the yellow value. Kvalue specifies 
the black value. You can use an integer percentage within the range of O to 100 for any of 
the CMYK values. 


CIELAB Lvalue (-)c1value (-)c2value 
Defines the CIELAB model. Use a range of 0.00 to 100.00 with Lvalue to specify the 
luminance value. Use signed integers from -—127 to 127 with c/value and c2value to 
specify the chrominance differences. 


Lvalue, c1value, c2value must be specified in this order. There are no defaults for the 


subvalues 


Note: Do 


not specify both an OCA color with the COLOR subparameter and an extended 


color model on the same FIELD or PRINTLINE command. The output is device 
dependent and may not be what you expect. 


Do 
PR 


PRINTLINE POSITION 1 IN .5 
COLOR 

PRINTLINE POSITION 1 I 
RGB 10 

PRINTLINE POSITION 1 IN 
cmyk 8 

PRINTLINE POSITION 1 I 
CIELAB 

PRINTLINE POSITION 1 IN 
highli 

PRINTLINE POSITION 1 I 
highli 


Figure 104. Color Model Usa 


not specify two extended COLOR subcommands on the same FIELD or 
INTLINE command. 


IN 
BLUE ; 
1 IN 
75 30; 
1.5 IN 
@ 10 10 10 ; 
2 IN 
80 100 20 ; 
2.5 IN 
ght 5 ; 
2.5 IN 
ght 300 COVERAGE 50 BLACK 30 ; 


ge 


OBJECT Specifies the placement of a resource object. If an internal name is coded, this is a known 
object defined by an OBJECT command. Otherwise, the object is a variable-named object 
whose name is extracted from fields in the line data as described by the START, 
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LENGTH, FLDNUM, or RECIDparameters. There is no OBJECT command for these 
objects, they must be specified with the OBTYPE and OBID parameters. 


Note: All of the OBJECT parameters are treated as positional parameters. All positional 
parameters must be coded in the exact position and order as specified in the 
syntax diagram. 


internal-name Specifies the name of an object that is up to 16 alphanumeric characters 


in length. The internal-name is used to match the PRINTLINE OBJECT 
subcommand to its definition from the OBJECT command. An object must 
be defined with this internal name by the OBJECT command. 


relative-xpos relative-ypos 


VARIABLE 


OBSIZE 


Specifies the number of units (inches, mm, and so on) that are added to 
the position of the current printline to position the top-left corner of the 
object. The values for the horizontal and vertical positioning are limited by 
the type of printer used and the L-units specified with the PELSPERINCH 
parameter on the PAGEDEF or PAGEFORMAT command. 


Each position specification can be a positive or negative number with up 
to three decimal places. The units specified can be one of the following: 
IN, MM, CM, POINTS, or PELS. 


Indicates that the actual name of the object is read from the data record. 
The Variable-Name-Locator field specifies where in the data to get the 
name. 


Note: If you specify VARIABLE for the OBJECT name and don’t want to 
print the name, then you must have at least one field command, or 
code PRINTDATA NO on the PRINTLINEcommand. 


START n The starting position in the data record to get the object 
name. The first data byte position of the input record is 1. 
If START is not coded, 1 is assumed. 


LENGTH n Length of field. Specifies the number (n) of bytes to 
process from the data record, beginning with the position 
specified in START. The maximum length is 8. 


Specifies the size of the object placement area. When no OBSIZE is 
specified, the default is the size specified in the object. If no size is 
specified in the object, the size of the page is used. The page width is as 
specified on the PAGEDEF or PAGEFORMAT commands, or it defaults to 
8.3 inches by 10.8 inches. 


wd Specifies the width of an object placement area as a number with 
up to three decimal places. The allowable width may vary with the 
type of printer used and the L-units specified with the 
PELSPERINCH parameter on the PAGEDEF or PAGEFORMAT 
command. 


hg Specifies the height of the object placement area as a number 
with up to three decimal places. The allowable height may vary 
with the type of printer used and the L-units specified with the 
PELSPERINCH parameter on the PAGEDEF or PAGEFORMAT 
command. 


unit Specifies a unit of measurement for the width parameter. The 
choices are: IN, MM, CM, POINTS, or PELS. 
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OBMAP 
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Note: If no unit is specified, the default is the most recent 
SETUNITS command value or IN (inch) if a SETUNITS 
command has not been issued. 


USEOBJ 
Specifies that the size measurements specified in the object are to 
be used. If no size is specified in the object, the size of the page 
is used, which is the length and width as specified on the 
PAGEDEF or PAGEFORMAT commands, or it defaults to 8.3 
inches by 10.8 inches. 


Specifies mapping options. The OBMAP parameter defines the mapping 
of the object to the object placement area. If OBMAP is not coded, the 
mapping option within the object is used. If the object does not contain a 
mapping option, then the print server sets it to the created default for the 
container type. 


Each object type (OBTYPE on the OBJECT command) specifies the 
allowable mapping options for that type. When it can, PPFA issues a 
message when these rules are violated. However, in the case of an object 
type of page segment (OBTYPE=PSEG), PPFA does not know what types 
of objects are contained in it; therefore, PPFA cannot enforce the 


restrictions. See |“OBJECT Command (Traditional)” on page 235] for a 


description of the restrictions. 


LEFT Specifies that the object is positioned at the upper, 
left-hand corner of the object placement area, as defined 
or defaulted by the relative-xpos, relative-ypos, 
OBCHPOS, and OBCVPOS parameters. Any portion of 
the object that falls outside the object placement area as 
defined by the OBSIZE parameter is not trimmed and 
could cause an exception condition by the presentation 
system. 


TRIM Specifies position and trim. The object is positioned at the 
upper, left-hand corner of the object placement area, as 
defined or defaulted by the relative-xpos, relative-ypos, 
OBCHPOS, and OBCVPOS parameters. Any portion of 
the object that falls outside the object placement area as 
defined by the OBSIZE parameter is trimmed. 


FIT Specifies scale to fit; this is the default value if the 
OBMAP parameter is not coded. The object is to be 
scaled to fit within the object placement area, as defined 
by the OBSIZE parameter. The center of the object is 
placed in the center of the object placement area and the 
object is scaled up or down to fit the block. Scaling in the 
horizontal and vertical directions is symmetrical. The FIT 
parameter ensures that all of the data in the object is 
presented in the object placement area at the largest 
possible size. The object is not trimmed. 


CENTER Specifies that the center of the object be positioned at the 
center of the object placement area. Any portion of the 
object that falls outside the object placement area is 
trimmed. 


REPEAT Specifies that the origin of the data object be positioned 
with the origin of the object placement area. The object is 


OBCHPOS 


OBCVPOS 
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then replicated in the X and Y directions. If the last 
replicated data does not fit in the object area, it is trimmed 
to fit. 


FILL Specifies that the center of the data object be positioned 
coincident with the center of the object placement area. 
The data object is then scaled, so that it totally fills the 
object placement area in both the X and Y directions. This 
may require that the object be asymmetrically scaled by 
different scale factors in the X and Y directions. 


Specifies the horizontal offset of the object contents within the object 
placement area. 


X-pos The valid options for x-pos are described in the 
SETUNITS command for the horizontal value. 

USEOBJ Specifies that the offset value from the object is to be 
used. If no value is set in the object, the value defaults to 
0. 


Specifies the vertical offset of the object contents within the object 
placement area, as defined by the OBSIZE parameter. If OBCVPOS is not 
specified, it defaults to USEOBJ and uses the value set in the object. If no 
value is set in the object, the value defaults to 0. The OBCHPOS 
parameter is used only in LEFT and TRIM mapping of the object into the 
object placement area. 


y-pos Specifies a positive or negative number. The valid options 
for y-pos are described in the SETUNITS command for 
the vertical value. 


USEOBJ Specifies that the offset value from the object is to be 
used. If no value is set in the object, the value defaults to 
0. 


OBROTATE {019011801270} 


~ Specifies the object rotation with respect to the current LND’s coordinate 


system. 


OBCOLOR colorname 


Specifies the color to be used as the default color or initial color for the 
object placement area. The OBCOLOR parameter is used only for objects 
of the PSEG, GOCA, BCOCA, and IOCA type. If the object type is 
OTHER, this parameter is ignored. Colors specified must be of the 
standard OCA color space. 


colorname Specifies standard OCA color space color names, which 
are: NONE, DEFAULT, BLACK, BLUE, BROWN, 
GREEN, RED, PINK (or MAGENTA), TURQ (or CYAN), 
YELLOW, DARKBLUE (or DBLUE), ORANGE, PURPLE, 
MUSTARD, GRAY, DARKGREEN (or DGREEN), 
DARKTURQ (or DTURQ), and DARKCYAN (or DCYAN). 


Note: This function requires both the print server and printer support. 
Check your print server and printer documentation. 
An included object is positioned and oriented in the following manner: 


¢ All measurements are from the LND position established by the 
PRINTLINE position. Reference these measurements using the inline 
direction of the printline. 
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¢ Measure the“relative-xpos and relative-ypos” units from the PRINTLINE 
current position to determine the object area origin. 

* Apply any rotation from OBROTATE to modify the PRINTLINE axis, and 
to create the new object area coordinate system. 

* Use the OBSIZE parameter to determine the object area size within the 
object area coordinate system, and to define the object placement area. 

* To determine the object content origin, apply the Object Content Offset 
from parameters OBCHPOS (OBject Content Horizontal Position) and 
OBCVPOS (OBject Content Vertical POSition) to the object area origin. 
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Note: The object content offset is used only for position (LEFT) and 


position and trim (TRIM) mapping options. 


Used to specify the type of the object. Observe that each of the object 
types restricts the type of mapping option allowed in the placement of the 
object (OBMAP on the OBJECT subcommand on the PRINTLINE 
command.) 


PSEG 


GOCA 


Specifies a page segment object, as described in the Mixed 
Object Document Content Architecture (MODCA) Reference 
Manual, SC31-6802. All mapping types (OBMAP) are allowed by 
PPFA, however, the print server issues an error if any of the 
objects contained in the page segment are not compatible with the 
coded OBMAP parameter. 


Specifies a graphic object, as described in the Graphics Object 
Content Architecture (GOCA) Reference Manual, SC31-6804. 
GOCA allows you to specify TRIM, FIT, CENTER, REPEAT, and 
FILL parameters on the OBMAP subcommand. 


BCOCA 


IOCA 


Specifies a bar code object, as described in the Bar Code Object 
Content Architecture (BCOCA) Reference Manual, S544—3766. 
BCOCA allows you to specify only the LEFT parameter on the 
OBMAP subcommand. 


Specifies an image object, as described in the Image Object 
Content Architecture (BCOCA) Reference Manual, SC31-6805. 
IOCA allows you to specify TRIM, FIT, CENTER, REPEAT, and 
FILL parameters on the OBMAP subcommand. 


OTHER 


OBID 


Specifies other object data. The object data to be included is a 
paginated presentation object with a format that may or may not 
be defined by an IBM presentation architecture. When you specify 
OTHER, you must also specify the OBID parameter. OTHER 
allows you to specify TRIM, FIT, CENTER, REPEAT, and FILL 
parameters on the OBMAP subcommand. 


Specifies either a component identifier or a type name from 
Table 12 on page 257} The OBID is translated into an Encoded 
OID and matched to the OID inside the object; they must match. 


component-id Specifies the component identifier. 


type-name The name chosen by PPFA as an alternative to 
coding a component identifier. 
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Table 12. Non-OCA Objects supported by |OB 


Type-Name Component-id Description of OBID Object Type 

EPS 13 Encapsulated PostScript 

TIFF 14 Tag Image File Format 

WINDIB 17 Device Dependent Bit Map [DIB], Windows Version 
OS2DIB 18 Device Dependent Bit Map [DIB], PM Version 
PCX 19 Paint Brush Picture File Format 

GIF 22 Graphics Interchange Format 

JFIF 23 JPEG File Interchange Format 

PDFSPO 25 PDF Single Page Object 

PCLPO 34 PCL Page Object 

EPSTR 48 EPS with Transparency 

PDFSPOTR 49 PDF Single Page Object with Transparency 
Table 13. Object Types that can be referenced as Secondary Resources 

Type-Name Component-id Description of OID Type-Name 

PDFRO 26 PDF Resource Object (new) 

RESCLRPRO 46 Resident Color Profile Resource Object 
IOCAFS45RO 47 IOCA FS45 Resource Object Tile (new) 


In the following example, the page definition pd1 has defined an object with an external name of 
“PSEGxyz”, of object type PSEG. The object has an internal name of “xyzintname”. The internal name 
identifies the object for the PRINTLINE OBJECT subcommand when the object is placed. Observe that 
case is not significant on either the internal nor the external names. 


PAGEDEF pdl Replace Yes 
COMMENT 'this is my program'; 


OBJECT xzZIntName 
OBXNAME PSEGxyz 
OBTYPE PSEG ; 


PAGEFORMAT pf1; 
PRINTLINE 
OBJECT xyzintname -1.1 in 2.1 in 
OBSIZE 3 in 5 in 
OBMAP FILL 
OBCOLOR BLUE ; 


Figure 105. Example of PPFA Support for IOB in a PAGEDEF 


The PRINTLINE in PAGEFORMAT pf1 places the object on the page 1.1 inches to the left and 2.1 inches 
below the current printline position. It also maps the object into the object area with the FILL parameter, 
which centers the object in the object area and totally fills the area, possibly with different scaling factors in 
the X and Y directions. It has an area size of 3 by 5 inches, and overrides the default presentation space 
color to BLUE. 
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SEGMENT Command 
>>—SEGMENT—name—3; 


<4 


Use the SEGMENT command only if you want page segments to be loaded to the printer before the page 
begins printing. If segments are used repeatedly and need to be available in the printer, this eliminates the 
need to load them each time. However, they do take up raster-pattern storage. If the segments are 
included on a page but not in the SEGMENT command, they are loaded to the printer as they are used in 
the print data. 


A separate SEGMENT command is required for each page segment with a maximum of 127 SEGMENT 
commands within a single page format. 


PAGEFORMAT 
TRCREF 
SEGMENT 
SEGMENT 


A SEGMENT command is nested within the page format and follows the PAGEFORMAT command. 


To include a page segment on a page without using an IPS structured field within the user data, see the 
“PRINTLINE Command (Traditional)” on page 244) 


SEGMENT name 
Specifies the alphanumeric name of 1 to 6 characters (user-access name) of the page 
segment. Each name must be unique within a single page format. 


Note: The prefix “S1” is not part of the six-character user-access name. 


258  PPFA User's Guide 


SETUNITS Command (Traditional) 
SETUNITS Command (Traditional) 


SETUNITS Command 


r 1 —IN— 1 i 
>>—SETUNITS | | ; a 

x Y LINESP—n IN 
IN IN MM 
MM MM CM 
CM CM POINTS 
POINTS POINTS PELS 
PELS PELS —LP | —_ 

—CPI—— —LP | —— 


The SETUNITS command specifies the value and the unit of measurement that are the defaults for any 
subsequent measurement parameter in all of the commands and subcommands. These values remain the 
default values until another SETUNITS command is specified. The SETUNITS command should be 
specified as the first command in a page definition. If neither this command nor a measurement parameter 
is specified, the defaults identified within the following description are used. 


SETUNITS Specifies the value and the unit of measurement that are the defaults for any subsequent 
measurement parameter in all of the commands and subcommands. 


x-pos Specifies the number used for horizontal measurement. A number with up to three 
decimal places is used. The default is 1. The choices are IN, MM, CM, POINTS, 
PELS, or LPI. The default is IN. 


Note: This value affects subsequent OFFSET subcommands. 


y-pos Specifies the number used for vertical measurement. A number with up to three 
decimal places is used. The default is 1. The choices are IN, MM, CM, POINTS, 
PELS, or LPI. The default is IN. 


Note: This value affects subsequent OFFSET subcommands. 
Using CPI and LPI Units of Measurement 


The CPI and LPI units of measurement make it possible to write the following command: 
SETUNITS 10 CPI 6 LPI ; 


This command sets the units of measurement for horizontal and vertical spacing in terms of characters per 
inch and lines per inch. You can then use the OFFSET subcommand specifications to increment the 
spacing one character or one line at a time. The distance specified by n characters over and by n lines 
down is defined in the governing SETUNITS command. In this example, there are 10 characters per inch 
(CPI) and 6 lines per inch (LPI). 


Subcommand 

LINESP Determines the line density or “leading” of the text. Any unit of measurement can be used. 
This subcommand values affects: 
* The following PRINTLINE NEXT subcommand 


* The vertical (y) position of the first line on a logical page when the LINEONE 
subcommand is not specified and the default is assumed 


The default is 6 LPI. If LINESP is allowed to default to 6 LPI, the LINEONE default is 1 
L-unit less than 80% of 1/6 inch. 
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n The meaning is determined by the type of unit-of-measurement specified in the 
unit parameter. 


LPI The number of lines per inch 
All others The distance between lines 


unit Specifies a unit of measurement. The choices are: 


IN Inch 

LPI Lines-per-inch 

MM Millimeter 

CM Centimeter 

PELS L-units per inch (The number of L-units per inch can be defined by 
the user or can default to 240 L-units in an inch) 

POINTS Points per inch (72 points in an inch) 
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TRCREF Command 


r--DIRECTION—ACROSS 7) 
>>—TRCREF- FONT—name | 7 >< 
al DIRECTION DOWN | ROTATION 90 | 
BACK. 180 
L_p—— 270 


The TRCREF command specifies the relationship between a font and a table-reference character (TRC) in 
the data. When specified, the TRCREF command must immediately follow a PAGEFORMAT command. 
PAGEFORMAT 
TRCREF 
SEGMENT 
OVERLAY 


Depending on the value specified for n, the TRC is interpreted by the print server as being either S/370 
1403 line-mode compatible or S/370 1403 line-mode incompatible: Notice that, if compatibility TRCs are to 
be used, no fonts should be specified in any PRINTLINE or FIELD commands within the same 
PAGEFORMAT. 

0-3 Indicate a compatible TRC for a S/370 1403 line-mode data stream 

4-126 Indicate a incompatible TRC for a S/370 1403 line-mode data stream 


Also notice that any TRC number outside the range of 0-3 results in non-compatibility TRCs for the entire 
page definition. If compatibility TRCs are used, do not specify fonts on PRINTLINE or FIELD commands 
within the same PAGEFORMAT. 


TRCREF n Specifies the TRC numbers that can appear in print data. 


n_ The allowable values are 0 to 126; each TRCREF command must contain a unique 
number within a page format. 


If n is omitted, PPFA automatically adds one to the n value of the previous TRCREF 
command in the sequence and assigns that value. 


The default for the first TRCREF command is 0. 
Notes: 


1. You may have multiple TRCs pointing to the same font. 


2. If 4 or fewer fonts are specified, they are treated as compatibility TRCs and the left 
most 4 bits of the TRC are ignored. For example, in this case X'FO' and X'00' are 
both valid for TRCO. 


Subcommands 


FONT name _ Specifies the font that is associated with the TRC number. 


name_ Specifies the local name of a font; the font must be one that has been named in a 
FONT command. 


If you have used both the user-access name and the local name in the FONT 
command, use the local name here. If you have used only the user-access name, 
use it here. 


DIRECTION _ Specifies the print direction of the line relative to the upper-left corner as you view the 
logical page. Not all printers can print in all print directions. For more information about 
your printer, refer to your printer documentation. 
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The DIRECTION on the TRCREF command must match the DIRECTION of the 
[PRINTLINE] command with which the TRC is to be used. If TRCREF DIRECTION 
subcommand is not specified, DIRECTION ACROSS is assumed. Observe that this 
direction is additive to the direction specified in the PAGEFORMAT command. 


ACROSS The page is printed with the characters added to the page from /eft to 
right, and the lines added from the top to the bottom. 


DOWN The page is printed with the characters added to the page from top to 
bottom, and the lines added from the right to the left. 


BACK The page is printed with the characters added to the page from right to 
left, and the lines added from the bottom to the top. 


UP The page is printed with the characters added to the page from bottom to 
top, and the lines added from the left to the right. 


ROTATION Specifies the rotation of characters in degrees. The specified value is relative to the inline 
direction of the printline. 


Valid rotations are 0°, 90°, 180°, or 270°; 0 is the default. 


lf the TRCREF ROTATION subcommand is not specified, the default is the rotation value 
specified on the |FONT| command. 
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Chapter 11. Page Definition Command Reference (Record 
Formatting and XML) 


This section describes Record Formatting Line Data Processing and XML Page Definition Processing (for 


Traditional Line Data Processing, refer to|Chapter 10, “Page Definition Command Reference (Traditional)” 
ion page 207), and includes: 


* Sequence of record formatting commands for page definitions 
* Sequence of commands for XML page definitions 
* Commands listed alphabetically 
* Detailed information on each command 
* Descriptions of the applicable subcommands and parameters for each command 


Sequence of Record Formatting Commands for Page Definitions with 
LAYOUT 


[ SETUNITS ...] 
PAGEDEF 

FONT 

[OBJECT ... ] 
[DEFINE COLOR... ] 
[ PAGEFORMAT ] 


[ SEGMENT ...] 

[ OVERLAY ...] 

[ LAYOUT ...] 
[ CONDITION ...] 
[ FIELD ...] 


[ DRAWGRAPHIC ...] 
[ ENDGRAPHIC ...] 
PAGEFORMAT ] 


Oo 


[ SEGMENT ...] 

[ OVERLAY ...] 

[ LAYOUT ...] 
[ CONDITION ...] 
[ FIELD ...] 


[ DRAWGRAPHIC ...] 
[ ENDGRAPHIC ...] 


¢ LAYOUT commands and PRINTLINE commands cannot be used within the same PAGEDEF. At least 
one LAYOUT command is required per page format for a record formatting page definition. 

¢ A SETUNITS command can be placed before any other PPFA command. The values set are in effect 
until the next SETUNITS command. 


¢ SEGMENT and OVERLAY commands must be specified under their associated PAGEFORMAT 
command. 


The first PAGEFORMAT command can be omitted in a page definition, if the page definition contains 
only one page format. If the PAGEFORMAT command is omitted, the PAGEDEF command parameters 
are used to define the page format. 


* One file can contain multiple sets of page definitions. 
¢ Atleast one FONT command is required for each PAGEDEF command. 
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Sequence of Commands for XML Page Definitions with XLAYOUT 


[ SETUNITS ...] 
PAGEDEF 

FONT 

[OBJECT ... ] 
[DEFINE COLOR... ] 
[DEFINE QTAG] 


[ 


oo 


PAGEFORMAT ] 


[ SEGMENT ...] 

[ OVERLAY ...] 

[ XLAYOUT ...] 
[ CONDITION ...] 
[ FIELD ...] 


[ DRAWGRAPHIC ...] 
[ ENDGRAPHIC ...] 
PAGEFORMAT ] 


[ SEGMENT ...] 

[ OVERLAY ...] 

[ XLAYOUT ...] 
[ CONDITION ...] 
[ FIELD ...] 


[ DRAWGRAPHIC ...] 
[ ENDGRAPHIC ...] 


XLAYOUT, XLAYOUT, and PRINTLINE commands cannot be mixed within the same PAGEDEF. At 
least one XLAYOUT command is required per page format for an XML page definition. At least one 
FONT command is required for each PAGEDEF command. 


A SETUNITS command can be placed before any other PPFA command. The values set are in effect 
until the next SETUNITS command. 


SEGMENT and OVERLAY commands must be specified under their associated PAGEFORMAT 
command. 


The first PAGEFORMAT command can be omitted in a page definition, if the page definition contains 
only one page format. If the PAGEFORMAT command is omitted, the PAGEDEF command parameters 
are used to define the page format. 


One file can contain multiple sets of page definitions. 


Diagram Shorthand 


These terms are used in the command definitions: 


X-pos_ A horizontal position using a numeric number followed optionally by a unit. For the available units, 
see|“Units of Measurement” on page 166 

y-pos Avertical position using a numeric number followed optionally by a unit. For the available units, 
see|“Units of Measurement” on page 166 
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CONDITION Command 


>>—CONDITION—condname START—n—LENGTH—n > 
START - 1 LENGTH—longest | 
FLDNUM—n 
START—n LENGTH—n 
BEFORE SUBPAGE NEWFORM 
>—_WHEN——CHANGE 
oL text’ AFTER LINE NEWS IDE 
NE CURRENT or = 
GT FIRST CURRENT or = —+ 
GE NULL or / FIRST 
LT. NEXT NULL or / 
Lie |_COPYGROUP—name NEXT 
L_PAGEFORMAT—name— 
>. . >< 
BEFORE SUBPAGE NEWFORM | 
OTHERWISE 
AFTER LINE NEWS IDE 
CURRENT or = 
FIRST CURRENT or = —+ 
NULL or / ———j__ FIRST. 
NEXT NULL or / 
--COPYGROUP—name NEXT. 
L_PAGEFORMAT—name— 
Short Form 
>>—CONDITION—condname ; >< 
ST, art—n_ 
CONDITION The CONDITION command examines data in an input record and specifies actions to be 
taken based on the result of the examination. 
* The condname parameter must come before any subcommands 
¢ No WHEN subcommand can follow an OTHERWISE subcommand in the same 
CONDITION command 
condname Names the condition. The name must contain 1 to 8 alphanumeric 
characters. 
PPFA allows cross-referencing to the condname. The cross-reference is 
done by using the short form of the CONDITION command (second format 
in the syntax table). By specifying a previously defined condname, PPFA 
uses the specifications from that command. When the condition is reused, 
the point where you want the comparison to begin may be at a different 
point in the record. By specifying the optional START subcommand, you 
can change the starting point of the comparison but not the field length. If 
the START subcommand is not specified, the starting point is the same as 
defined in the original CONDITION command. 
Subcommands 
START n Specifies the starting position of characters to be compared within the data base where 


the comparison is to be done. 
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LENGTH n 


FLDNUM 


WHEN 


n_ Specifies the number of bytes from the first data byte in the record as the starting 
point of the comparison field. The first data byte position of an input record is 1. 


Note: The carriage-control character and the record id are not considered data, therefore 
the first character of data starts in column eleven. 


Specifies the length of the field to be compared within the database. 


n_ Specifies the number of bytes in the data record to be compared, beginning with the 
position specified in START. Valid values are numbers from 1 to 8000. The length of 
the constant text must be the same as defined in this parameter or the results are 
invalid. 


Comparisons are done on a byte-by-byte basis. Because the comparison field and the 
constant text must have the same lengths, padding is not necessary. 


Note: If any part of the comparison field specified by the combination of START and 
LENGTH is outside the boundaries of the data record, all conditional processing is 
not performed. No WHEN is executed. If an OTHERWISE is present, it is not 
executed either. 


Field number to be used in comparison. This keyword should only be used if the 
DELIMITER field was used in the LAYOUT command. Fields cannot be counted without 
delimiters being specified in the database. When counting, the first field after the record id 
is to be considered FLDNUM 1. 


To allow for the identification of a part of a field which has been numbered, you can 
specify the starting position (from the delimiter) and the length of the field to be used in 
the WHEN condition (the default of the Jongest parameter is the length of the longest 
condition or when no specific condition is specified [i.e. when change] it is from the 
starting position to the end of the field.) 


Marks the start of the conditional comparison parameters. At least one WHEN 
subcommand is required. 


comparisontype={EQINEIGTIGEILTILE} 
Specifies the type of comparison that is to be performed between the data 
in the comparison field (the portion of the record specified by START and 
LENGTH) and the constant text defined in the text parameter. 


The choices are: 

EQ equal to 

NE not equal to 

GT greater than 

GE greater than or equal to 


LT less than 
LE less than or equal to 
text Specifies constant text for comparison with the comparison field text. The 


constant text length must be the same as the value on the LENGTH 
subcommand, with a maximum length of 8000 bytes. Examples of valid 
text are: 

2C(3) 'AB' 

K'321,400' 

X'41FE7799' 2 'CHARS' 


Any values or parameters that are valid for the TEXT subcommand within 
the FIELD command may be used as text; see the EXT 
subcommand. 
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CHANGE 


BEFORE 
AFTER 
LINE 
SUBPAGE 


NEWFORM 


NEWSIDE 


CONDITION Command (Record Format and XML) 


Specifies that the contents of the comparison field in this record are to be 
compared with the field in the record last processed by the same 
CONDITION command. 


This parameter is an alternative to the comparisontype and text parameter 
combination but can be specified only once in a CONDITION command. 


The results of the comparison is either TRUE or FALSE. 


TRUE When the contents of the comparison field have changed from one 
record to the next. 


FALSE 
When the print server processes the data, if the comparison field 
lies outside the boundary of the current record, which may occur 
with variable-length records or with truncated trailing blanks, the 
current record is not used in future comparisons. 


CHANGE is always false if used with the first WHEN 
subcommand of a series (no previous record to compare against). 
Whenever a new data map (one with a different name) is invoked, 
all the CHANGE comparisons are reset. Field values in the 
previous data map are not retained. 


Specifies that the conditional action takes place before the current line or 
subpage is processed. This is the default. 


Specifies that the conditional action takes place after the current line or 
subpage is processed. 


Specifies that the conditional action takes place either before or after the 
current line. 


Specifies that the conditional action takes place either before or after the 
current subpage. This is the default. 


NEWFORM specifies that the only action to be taken is skipping to the 
front of a new form (sheet) and restarting the page format. 


Note: This parameter is an alternative to using the COPYGROUP and 
PAGEFORMAT parameters, and is equivalent to specifying 
CURRENT for the COPYGROUP parameter and NULL for the 
PAGEFORMAT parameter. CURRENT NULL are the respective 
defaults for COPYGROUP and PAGEFORMAT parameters; 
therefore, NEWFOR\M is the default action. 


Specifies that the only action to be taken is skipping to a new side (either 
the back of the current sheet or the front of a new sheet) and restarting 
the page format. 

Notes: 


1. This parameter is an alternative to using the COPYGROUP and 
PAGEFORMAT parameters, and is equivalent to specifying NULL for 
the COPYGROUP parameter and CURRENT for the PAGEFORMAT 
parameter. 


2. Conditional processing does not result in unnecessary blank pages. 


If the line currently being processed is the first line on a side, then: 


* A COPYGROUP or NEWFORM action taking effect BEFORE LINE 
does not force an additional new form. 
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* A PAGEFORMAT or NEWSIDE action taking effect BEFORE LINE 
does not force an additional new side. 


Similarly, additional sides or forms are not forced by BEFORE SUBPAGE 
if the line currently being processed is in the first subpage on a side or a 
form. 

copygroup options 
Specifies a copy group to be invoked if the condition is true. 


Note: Any copy group action (except NULL) restarts the page format. 


{ CURRENT or = } 
Invoke the current copy group again. This results in ending printing on the 
current sheet and resuming on the front side of a new sheet. This is the 
default. 


The page format is restarted. This means that the first input record to go 
on the new page is printed using the first LAYOUT command of the 
current page format, and so on. For example, data that was to be printed 
as subpage 4 on the sheet might be printed on subpage 1 on the new 
sheet. 


FIRST Invokes the first copy group in the current form definition. 
{ NULL or/} Retains the current copy group, taking no action. 


NEXT Invokes the next copy group in the current form definition. 


Note: If NEXT is specified from the last copy group in the form definition, 
the first copy group in the form definition is used. 
COPYGROUP cgname 
Uses the named copy group defined in the current form definition. The 
name must contain 1 to 8 alphanumeric characters. 


pageformat options 
Specifies a page format to be invoked if the condition is true. 


{ CURRENT or = } 
Invokes the current page format again. This results in ending printing on 
the current sheet and resuming on the front side of a new sheet. 


The page format is restarted. This means that the first input record to go 
on the new page is printed using the first LAYOUT command of the 
current page format, and so on. 


FIRST Invokes the first page format in the current page definition. 
{ NULL or/} Retains the current page format, taking no action. This is the default. 


NEXT Invokes the next page format in the current page definition. 


Note: If NEXT is specified from the last page format in the page 
definition, the first page format in the page definition is used. 
PAGEFORMAT pfname 
Uses the named page format defined in the current page definition. The 
name must contain 1 to 8 alphanumeric characters. 
OTHERWISE parameters 


Marks the start of a conditional action to be taken if all preceding WHEN comparisons 
have proved false. The syntax is the same as the WHEN subcommand, except that the 
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comparison parameters (comparisontype text or ‘CHANGE’) are not used. See the WHEN 
parameters starting with for a description of the parameters. 


If the OTHERWISE subcommand is not used within the sequence, no action is taken. This 
is the same as if OTHERWISE NULL NULL had been entered. 


Note: OTHERWISE is not executed if any part of the comparison field specified by the 
combination of START and LENGTH is outside the boundaries of the data record. 


Chapter 11. Page Definition Command Reference (Record Formatting and XML) 269 


DEFINE COLOR Command (Record Format and XML) 
DEFINE COLOR Command (Record Format and XML) 


DEFINE COLOR Command 


>>—DEFINE—colorname—COLOR OCA BLUE : >< 
RED. 
L-MAGENTA or PINK 
GREEN 
t-CYAN or TURQ 
YELLOW. 
BLACK. 
BROWN 
MUSTARD 
t-DARKBLUE. 
L-DARKGREEN 
t-DARKTURQ or DARKCYAN 
ORANGE 
PURPLE 
GRAY: 
NONE 
DEFAULT. 
RGB—rvalue—gvalue—bvalue 
t-CMYK—cvalue—mvalue—yvalue—kvalue 
t-HIGHLIGHT—hvalue 


__COVERAGE—cvalue | BLACK—bvalue | 
CIELAB—Ivalue 7 clvalue 7 c2value 
_(-) _(-) 


DEFINE COLOR 
Defines a color name of a particular color model such as OCA, RGB, CMYK, 
HIGHLIGHT, or CIELAB. This name can be used anywhere color of that model is allowed. 
For example a defined color of any color model can be used as text color in the FIELD or 
PRINTLINE commands, but only a color defined as an OCA color can be used as an 


object placement area color. See the OBCOLOR subcommand in|“XLAYOUT Command 
(XML)” on page 351 


colorname Select a 1 to 10 character name. Use this name on the command to 
identify this color. For example: 


DEFINE oldblue COLOR OCA brown; 
PRINTLINE COLOR oldblue; 


Subcommands 


COLOR Specifies the color of print for this field supported in MO:DCA for the OCA, the 
Red/Green/Blue color model (RGB), the highlight color space, the 
Cyan/Magenta/Yellow/Black color model (CMYK), and the CIELAB color model. 


OCA _ Chose one of the standard OCA colors from the previous syntax diagram. 


PPFA supports the following synonyms: 
* CYAN for TURQ 

* DARKCYAN for DARKTURQ 

* DBLUE for DARKBLUE 

* DCYAN for DARKTURQ 

* DGREEN for DARKGREEN 

* DTURQ for DARKTURQ 

* MAGENTA for PINK 


Note: In some printer publications, the color turquoise (TURQ) is called “cyan”, 
and the color pink (PINK) is called “magenta”. 


270 =~ PPFA User's Guide 


DEFINE COLOR Command (Record Format and XML) 


RGB rvalue gvalue bvalue 
Three RGB integer values are used. The first (rva/ue) represents a value for red, 
the second (gva/ue) represents a value for green, and the third (bvalue) 
represents a value for blue. Each of the three integer values may be specified as 
a percentage from 0 to 100. 


Note: An RGB specification of 0/0/0 is black. An RGB specification of 
100/100/100 is white. Any other value is a color somewhere between black 
and white, depending on the output device. 


HIGHLIGHT hvaiue COVERAGE cvalue BLACK bvalue 
Indicates the highlight color model. Highlight colors are device dependent. 


You can use an integer within the range of 0 to 65535 for the hvalue. 


Note: An hvalue of 0 indicates that there is no default value defined; therefore, 
the default color of the presentation device is used. 


COVERAGE indicates the amount of coverage of the highlight color to be used. 
You can use an integer within the range of 0 to 100 for the cvalue. If less than 100 
percent is specified, the remaining coverage is achieved with the color of the 
medium. 


Note: Fractional values are ignored. If COVERAGE is not specified, a value of 
100 is used as a default. 


BLACK indicates the percentage of black to be added to the highlight color. You 
can use an integer within the range of 0 to 100 for the bva/ue. The amount of 
black shading applied depends on the COVERAGE percentage, which is applied 
first. If less than 100 percent is specified, the remaining coverage is achieved with 
black. 


Note: If BLACK is not specified, a value of 0 is used as a default. 


See |*Color on the IBM Infoprint HiLite Color Post Processor’ on page 47|for more 


information. 


CMYK cvalue mvalue yvalue kvalue 
Defines the cyan/magenta/yellow/black color model. cvalue specifies the cyan 
value. mvalue specifies the magenta value. yvalue specifies the yellow value. 
kvalue specifies the black value. You can use an integer percentage within the 
range of 0 to 100 for any of the CMYK values. 


CIELAB Lvalue (-)c1value (-)c2value 
Defines the CIELAB model. Use a range of 0.00 to 100.00 with /va/ue to specify 
the luminance value. Use signed integers from —127 to 127 with c1value and 
c2value to specify the chrominance differences. 


Ivalue, c1value, c2value must be specified in this order. There are no defaults for 
the subvalues. 


Note: Do not specify both an OCA color with the COLOR subparameter and an 
extended color model on the same FIELD or LAYOUT command. The 
output is device dependent and may not be what you expect. 
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DEFINE QTAG Command 


>>—DEFINE—qtagname—QTAG 


DEFINE QTAG 


272 


Y starttag ; >< 


Defines a local identifier for a qualified tag which can be used later in the page definition 
on a XLAYOUT command. A QTAG is a sequence of one or more start-tag names which 
taken together identify an XML data element. This is the logical equivalent of the “record 
IDentifier’ on the LAYOUT command for a record formatting page definition. But, instead 
of identifying an entire record as the LAYOUT command does, the QTAG identifies a 
single XML data element. 


When used, the local identifier makes the coding of an XLAYOUT command easier by 
allowing the use of a locally defined name instead of the fully-qualified set of start tags. It 
also makes the XLAYOUT command syntax similar to the LAYOUT command. 


qtagname 


starttag 


The internal name assigned to the fully-qualified QTAG. This name can be 
used on the XLAYOUT command to identify the XML data item. This 
name is not case sensitive. It can be up to 16 characters in length. 


An XML element name. This name must match exactly to the element 
name in the XML data. To preserve the case for the name, put it in 
quotes. Otherwise, the name is folded to upper case. If necessary, the 
name is translated to the datatype specified or defaulted by the UDTYPE 
subcommand on the PAGEDEF command. For example, if the page 
definition is coded on an EBCDIC platform, but the UTDTYPE specifies 
UTF8, PPFA converts the start tags from EBCDIC code page 500 to 
UTF-8. 


See the |“XLAYOUT Command (XML)” on page 351}for an example of using a defined 
QTAG with an XLAYOUT command. 
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DRAWGRAPHIC - BOX Command 


GRAPHID—00— 


>>—DRAWGRAPHIC—BOX: | 


GRAPHID—nn— 


--POSITION - LPOS - NEXT. 


POSITION—-—LPOS NEXT 
-( +) LPOS (+) 
| horiz vert 
tpost Ly _) IN Ly) IN 
MM MM 
CM CM 
POINTS POINTS 
L-PELS—— LpELS—— 
LPOS 
cpos_! (+) 
vert 
L(-)- IN——+ 
MM——— 
—— 
POINTS 
PELS—— 


--LINEWT - MEDIUM 
P2087 se 
IN height MEDIUM LINEWT. MEDIUM 


>< 


ROUNDED: 
MM IN SMALL LIGHT—4 
CM. MM. t-LARGE—4 BOLD— 
POINTS CM. LMAX——} n 
L-PELS— POINTS: 
-PELS—— 
--LINETYPE - SOLID 
> 
LINETYPE. SOLID SPACED - 0 
DOTTED COLOR—colorname COPY. ACROSS n 
L-SHORTDASH—- DOWN SPACED—n 
DASHDOT: IN—— 
DBLDOT: MM——+ 
LONGDASH CM——_ 
L_DSHDBLDOT— POINTS 
PELS—— 
> 3 
| ALL, SOLID 
FILL 
BOX—n NOFILL COLOR. éofonname-! 
DOTO1 
DOTO2 
DOTO3 
DOTO4 
DOTO5 
DOTO6 
DOTO7. 
DOTO8 
VERTLN: 
HORZLN 
}+-BLTRI— 
BLTR2 
TLBR1 
_TLBR2— 


The DRAWGRAPHIC - BOX command allows you to generate GOCA objects in order to draw boxes on 


the page. 
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Note: GOCA boxes require specific microcode in your printer. 


This command allows you to draw a box of varying attributes and colors at either the current line position 
or a specified position. DRAWGRAPHIC can be used with the COLOR parameter and DEFINE COLOR to 
shade a box with a percentage of black or other colors. 


Subcommands 

GRAPHID Specified number is used to later identify as the box or set of boxes to be closed by the 
ENDGRAPHIC. The default is ‘00’. 

POSITION Horizontal and vertical position for first box. This position is relative to the LAYOUT 
command’s position statement or the current position. 

LPOS and CPOS refer to Layout Position and Current Position respectively. If LPOS is 
used alone, the position is used exactly at the same position as is specified on the 
LAYOUT command. If it is used with a + or — value, the position moves that amount from 
the LAYOUT position. The same is true for Current position except that the position is 
taken from the previous FIELD or DRAWGRAPHIC command. 

BOXSIZE Specify the horizontal and, optionally, vertical dimensions of the box. The first parameter is 
required and specifies the horizontal width of the box, which is a fixed size. The second 
parameter is optional and if given, specifies the fixed vertical depth of the box. If the 
second parameter is omitted, the box is a variable size or “floating” box. For a floating box, 
the depth of the box is determined when the box is closed with an ENDGRAPHIC 
command. 

ROUNDED Size of the rounded cornerlength is determined by the following parameters: 

MEDIUM Medium cornerlength - equates to a radius of 20 pels at 240 pels/inch or 
120 pels at 1440 pels/inch 

SMALL Small cornerlength - equates to a radius of 10 pels at 240 pels/inch or 60 
pels at 1440 pels/inch. 

LARGE Large cornerlength - equates to a radius of 30 pels at 240 pels/inch or 180 
pels at 1440 pels/inch 

MAX Maximum cornerlength gives an arc with a radius that extends half the 
length of the shortest box side. If boxes are rounded MAX, they cannot be 
open-ended. 

LINEWT Specify either one of the following keywords or the number of lineweights to be used (1 
lineweight = .01 inch). Specify O if you want invisible borders (type and color are then 
ignored). 

LIGHT the same as LINEWT .01 inch. 
MEDIUM the same as LINEWT .02 inch. 
BOLD the same as LINEWT .03 inch. 

LINETYPE Specify one of the following keywords for the border type: 

SOLID 
DOTTED 
SHORTDASH 
DASHDOT 
DBLDOT (double dot) 
LONGDASH 
DSHDBLDOT (dash double dot) 
COLOR Color to be used for the box border. The colorname must be either one of the pre-defined 


OCA keywords or the colorname from the DEFINE COLOR command. 
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COPY Repeat the same box at regular intervals either across or down the page. Total number of 
boxes is one more than the value specified on this parameter. 


Restriction: If boxes are repeated in the DOWN direction, they cannot be open-ended. 


.25 in .2in .25 in .2in .25 in 


1.8 in + 4 pels 


Figure 106. Spaced Boxes (not to scale). 


l< .25 in AP .25 in up .25 in sl .25 in AP .25 in , 


1.25 in + 6 pels 


Figure 107. Boxes Spaced 0 (not to scale). 


SPACED Spacing between the boxes can be specified directly. The default is to have no space 
between the boxes. If there are no spaces between the boxes, the common border is 
shared and not duplicated. 


FILL Allows the option of filling a box with a pre-defined GOCA pattern and optionally specifying 
a color. The numbering of the boxes is done in the order they are defined within this one 
command - 1,2,3,.... Filling follows the rule that the “last fill wins”. 


The NOFILL keyword fills ALL boxes with one fill pattern, then specify NOFILL on one 
box to remove that box’s pattern. 


For an example of the various GOCA-supported fill patterns, see|Figure 131 on page 437 


The NOFILL keyword can be used when a series of boxes has been specified as filled 
and one or more of them are to be left empty. In the example, boxes 1, 2, 4, and 5 are 
filled with solid blue and box 3 is empty: 

LAYOUT ... 

Drawgraphic BOX boxsize 1 in .2 in copy down 4 

Linetype solid color green 

FILL ALL SOLID Color Blue 

FILL Box 3 NOFILL; 


ALL All boxes are filled. 


BOX n boxes are numbered starting at 1 for the initial box in this command, and increasing 
through the use of the COPY parameter. 
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DRAWGRAPHIC - LINE Command 


>>—DRAWGRAPHIC—LINE 


--POSITION - LPOS - NEXT. 


GRAPHI 


D—00: 


\_GRAPHID—nn— 


“POSITION 


TO horiz 
ECs al 


--LINETYPE - SOLID 


I vert 


IN 


MM. 


CM 


POINTS 


-PELS—— 


LPOS NEXT 
(+) LPOS (+) 
horiz vert 
post Ly) IN L¢-) IN 
MM MM 
CM CM 
POINTS POINTS 
LpELS—_ PELS—— 
LPOS 
cpos_] ay 
vert 
L(- ja IN 
MM 
CM 
POINTS 
LpeELS— 


--LINEWT - MEDIUM 
P= AEROSS— eng ff f=" 
IN LINEWT. MEDIUM. 


LIGHT: 


=H 


+-BOLD——-4 


>< 


L__LINETYPE. 


SOLID: 


COPY. 


ACROSS 


n—SPACED—n 


DOTTED: 


COLOR 


eoimename— 


L-SHORTDASH- 
DASHDOT: 


DBLDOT: 


[-LONGDASH— 


\_DSHDBLDOT— 


L_pown— 


The DRAWGRAPHIC - LINE command allows you to use GOCA (Graphic Character Global Identifier) 
objects in order to draw lines on the page. 


Note: GOCA lines require specific microcode in your printer. 


The DRAWGRAPHIC - LINE command allows you to create either one straight line or a series of straight 
lines from either the current line position or a specified position. 
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Subcommands 


GRAPHID 


POSITION 


Specifies a number used to later identify the graphic line to be closed by the 
ENDGRAPHIC. The default is ‘00’. 


Horizontal and vertical position for the start of the first line. This position is relative to 
either the Layout Position parameter or the current position. 


LPOS and CPOS refer to Layout Position and Current Position respectively. If LPOS is 
used alone, the position is used exactly at the same position as is specified on the 
LAYOUT command. If it is used with a + or — value, the position moves that amount from 
the Layout position. The same is true for Current position except that the position is taken 
from the previous FIELD or DRAWGRAPHIC command. 


ACROSS or DOWN 


TO 


LINEWT 


LINETYPE 


COLOR 


COPY 


Specify the line length in either the ACROSS or DOWN directions. If ACROSS is 
specified, the line length must also be specified. If DOWN is specified and the n units 
value is not entered, the line continues until either a logical page eject is executed or an 
ENDGRAPHIC is found. 


Horizontal and vertical ending positions for the line. Used for lines that are point-to-point. 
The TO position is specified relative to the POSITION parameter values in this command. 


Specify either one of the following keywords or the number of lineweights to be used (1 
lineweight= .01 inch). 


LIGHT the same as LINEWT .01 inch. 
MEDIUM the same as LINEWT .02 inch. 
BOLD the same as LINEWT .03 inch. 


Specify one of the following keywords for the line type: 
SOLID 
DOTTED 
SHORTDASH 
DASHDOT 
DBLDOT (double dot) 
LONGDASH 
DSHDBLDOT (dash double dot) 


Color to be used for the line. The colorname must be either one of the pre-defined OCA 
keywords or the colorname from the DEFINE COLOR command. 


Repeat the same line at regular intervals either across or down the page. Total number of 
lines is one more than the value specified on this parameter. 
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DRAWGRAPHIC - CIRCLE Command 
POSITION - LPOS - NEXT 


>>—DRAWGRAPHIC—CIRCLE 


ea LPOS 


--LINETYPE - SOLID 


NEXT. 
(+) LPOS (+) 
| horiz vert 
LPOS: (-) IN (-) IN 
MM. MM 
CM. CM 
POINTS POINTS 
L-PELS—— L-PELS— 
LPOS 
~ Lepos (+) 
vert 
(-) IN 
MM. 
Lcm——_] 
POINTS. 
L-PELS— 


LINEWT - MEDIUM 
wt Sn pf se 
IN LINEWT MEDIUM LINETYPE SOLID: 


MM: LIGHT 

CM. BOLD. 

POINTS Ln 
LPELS—— 


DOTTED: 


COLOR—colorname 


SHORTDASH: 
DASHDOT- 
}-DBLDOT——+ 
LONGDASH 
'_DSHDBLDOT—' 


>< 


SPACED - DIAMETER | 
| 


COPY. heal n [ 
DOWN: 


SPACED—n 


ALL. SOLID. | 
Y_FILL 


IN 

MM. 

CM 

POINTS 
L-PELS—— 


CIRCLE—n 


NOFILL. COLOR—colorname: 


__TLBR2— 


The DRAWGRAPHIC - CIRCLE command allows you to generate GOCA (Graphics Object Content 
Architecture) objects in order to draw circles on the page. 


Note: GOCA circles require specific microcode in your printer. 


The DRAWGRAPHIC - CIRCLE command allows you to create a circle at either a specified radial 
distance from the last line printed or a specified position. 


DRAWGRAPHIC can be used with the COLOR parameter and DEFINE COLOR to shade a circle with a 


percentage of black or other colors. 


Subcommands 


POSITION Horizontal and vertical position of the center of the first circle. This position value is 
relative to either the Layout Position parameter or the current position. 


LPOS and CPOS refer to Layout Position and Current Position respectively. If LPOS is 
used alone, the position is used exactly at the same position as is specified on the 
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LINEWT 


LINETYPE 


COLOR 


COPY 
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LAYOUT command. If it is used with a + or — value, the position moves that amount from 
the Layout position. The same is true for Current position except that the position is taken 
from the previous FIELD or DRAWGRAPHIC command. 


Specify the circle radius. (The radius is measured from the center of the circle to the 
middle of the line width.) 


Specify either one of the following keywords or the number of lineweights to be used (1 
lineweight = .01 inch). Specify O if you want invisible borders (type and color are then 
ignored). 


LIGHT the same as LINEWT .01 inch. 
MEDIUM the same as LINEWT .02 inch. 
BOLD the same as LINEWT .03 inch. 


Specify one of the following keywords for the line type: 
SOLID 
DOTTED 
SHORTDASH 
DASHDOT 
DBLDOT (double dot) 
LONGDASH 
DSHDBLDOT (dash double dot) 


Color to be used for the circle border. The colorname must be one of the pre-defined OCA 
keywords or the colorname from the DEFINE COLOR command. 


Repeat the same circle at regular intervals either across or down the page. Repeating 
ACROSS or DOWN with the DIAMETER indication means that the circles are placed to 
join at one point with the center positions of each being one diameter width apart. See 
following figures for a pictorial view of repeating circles. 


Total number of circles is one more than the value specified on this parameter. 


OOO 


Sin 45 in 45 in .45 in 
>< >\< tl >| 


I 1.65 in + 4 pels >| 


Figure 108. Repeating circles with .45 inch spacing (not to scale). 


in 
—_—>| 


e— 6in+6pels — 


Figure 109. Repeating circles with DIAMETER spacing (not to scale). 


FILL 


Allows the option of filling a circle with a pre-defined GOCA pattern and optionally 
specifying a color. Circles are numbered in the order they are defined within this command 
- 1,2,3,.... Filling follows the rule that the "last fill wins”. 
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Using the NOFILL keyword fills ALL circles with one fill pattern. Then specify NOFILL on 
one circle to remove that circle’s pattern. 


For an example of the various GOCA-supported fill patterns, see|Figure 131 on page 437 
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DRAWGRAPHIC - ELLIPSE Command 


--POSITION - LPOS - NEXT. 


POSITION LPOS NEXT. 
-( +) LPOS (+) 
| horiz vert 
teas} Ly) IN ae IN 
MM. MM 
CM. CM 
POINTS POINTS 
LPELS—— LPELS——! 
LPOS 
CPOS (+) 
vert 
L(- )H IN——+ 
MMt—— 
CM] 
POINTS 
PELS—— 
(+) (+) 
>-AXIS1 n n > 
L(-)- IN L(-)- IN 
MM. L-MM. 
CM. L-CM 
t-POINTS t-POINTS 
LPELS—— L-PELS. 
—( +) -(+) —LINEWT - MEDIUM 
>-AXIS2 | n a n > 
(-) | IN (-) IN LINEWT. MEDIUM, 
MM. LMM: LIGHT. 
CM. L-CM BOLD. 
POINTS L-POINTS Ln. 
LPELS—— L-PELS. 
--LINETYPE - SOLID: 
> . >< 
LINETYPE. SOLID. 
DOTTED COLOR ‘eo tonoeme! | SOLID 
L-SHORTDASH— FILL: 
DASHDOT: NOFILL. COLOR éuiernae! 
DBLDOT: DOTO1 
LONGDASH DOTO2 
LDSHDBLDOT DOTO3. 
DOTO4- 
DOTO5 
DOTO6 
DOTO7 
DOTO8 
VERTLN 
HORZLN 
BLTR1 
BLTR2 
TLBR1 
LTLBR2— 


Chapter 11. Page Definition Command Reference (Record Formatting and XML) 281 


DRAWGRAPHIC - ELLIPSE Command (Record Format and XML) 


The DRAWGRAPHIC - ELLIPSE command allows you to draw ellipses on the page by generating GOCA 
(Graphics Object Content Architecture) structure fields. 


Note: GOCA lines require specific microcode in your printer. 


The DRAWGRAPHIC - ELLIPSE command allows you to create an ellipse with a number of positions 
showing the major and minor axes at a specified distance from the last line printed. 


The DRAWGRAPHIC can be used with the COLOR parameter and DEFINE COLOR to shade an ellipse 
with a percentage of black or other colors. 


Subcommands 


POSITION 


AXIS1 


AXIS2 


LINEWT 


LINETYPE 


COLOR 


FILL 


Horizontal and vertical position of the ellipse. 


LPOS and CPOS refer to Layout Position and Current Position respectively. If LPOS is 
used alone, the position is used exactly at the same position as is specified on the 
LAYOUT command. If it is used with a + or — value, the position moves that amount from 
the Layout position. The same is true for Current position except that the position is taken 
from the previous FIELD or DRAWGRAPHIC command. 


The first pair of n units specifies the location of one point on the ellipse specified in 
relation to the POSITION parameter on this command. This location is specified as if the 
POSITION parameter is now at (0,0) on a coordinate system. The x and y movements are 


either in the positive or negative direction from the center point at (0,0). For a picture of 
how this is used, see |Figure 110 on page 283] Point R,Q. 
The second pair of n units specifies the location of second point on the ellipse specified in 


relation to the POSITION parameter on this command. This location is specified as if the 
POSITION parameter is now at (0,0) on a coordinate system. The x and y movements are 


either in the positive or negative direction from the center point at (0,0). For a picture of 
how this is used, see |Figure 110 on page 283) Point P,S. 

Specify either a keyword or the number of lineweights to be used (1 lineweight = .01 inch). 
Specify 0 if you want invisible borders (type and color are then ignored). 


LIGHT the same as LINEWT .01 inch. 
MEDIUM the same as LINEWT .02 inch. 
BOLD the same as LINEWT .03 inch. 


Specify one of the following keywords for the line type: 
SOLID 
DOTTED 
SHORTDASH 
DASHDOT 
DBLDOT (double dot) 
LONGDASH 
DSHDBLDOT (dash double dot) 


Color to be used for the ellipse border. Specify either one of the pre-defined OCA 
keywords or the colorname from the DEFINE COLOR command. 


Allows the option of filling an ellipse with a pre-defined GOCA pattern and optionally 


specifying a filling color. For an example of the various GOCA-supported fill patterns, see 
Appendix G. "Fill Patterns” |Figure 131 on page 437 
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DRAWGRAPHIC - ELLIPSE Command (Record Format and XML) 


Orthogonal case (PeAS+Q) 


(0,1) (1,1) 


(1,0) 


Unit circle 


(P+R,S+Q) 


General case 


Figure 110. Ellipse parameters 


The dot in the center of the ellipse shows the POSITION parameter. The asterisk shows 
the major axis position and star shows the minor axis position. 
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ENDGRAPHIC Command (Record Format and XML) 


ENDGRAPHIC Command 


>>—ENDGRAPHIC 


pee -—-LPOS 
3 >< 
GRAPHID—nn | NEXT 
(+) 
vert 
LPOS | (-) IN 
MM 
CM 
POINTS 
--PELS-— 
LPOS 
Lcpos —( + I> 
vert 
bea IN 
MM 
CM 
POINTS 
L_PELS-—— 


The ENDGRAPHIC command allows you to end all active graphics with a matching graphic id. An active 
graphic is one that has been started but not ended, for example a vertical line or a box with no vertical 


size. 


Subcommands 


GRAPHID 


NEXT 


LPOS CPOS 


vert 


ID must match one previously defined ina DRAWGRAPHIC command. If no GRAPHID is 
specified, all DRAWGRAPHIC commands that have no GRAPHID are closed (for 
example, GRAPHID 00). 


Specifies the layout is to be positioned down (on the logical page) one line (as defined in 
the LINESP subcommand of the last SETUNITS command) from the previous field. The 
LINESP subcommand of the SETUNITS command establishes the distance from one line 
to the next. 


LPOS and CPOS refer to Layout Position and Current Position respectively. If LPOS is 
used alone, the position is used exactly at the same position as is specified on the 
LAYOUT command. If it is used with a + or — value, the position moves that amount from 
the Layout position. The same is true for Current position except that the position is taken 
from the previous FIELD or DRAWGRAPHIC command. 


This value is relative to the Layout position. If not specified, the graphics are closed one 
line spacing from the Layout position. 
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FIELD Command 


>>—FIELD. LENGTH—n > 
L start—n_t FONT—name1 | 
L, ene) 
Cc 
TEXT—Z text’ 
duplication X L (m) | 
G 
Lt 
PAGENUM—NOPRINT—NORESET: 
PRINT: NORESET 
PAGENUM | | 
NOPRINT RESET—n 
START - 1 LENGTH—rest of field— 
FLDNUM—n. | 
START - n LENGTH— n 
START - 1 LENGTH— rest of id— 
RECID 
L_START - n LENGTH—n 
ALIGN - LEFT. —-DIRECTION—ACR' 
: G — CTIO C oe : 
ALIGN LEFT: Lposit10N X-pos -Y-pos DIRECTION. DOWN | 
| eiguT_ Leal ae BACK: 
L_CURRENT or * NEXT. Lyp— 
L_CURRENT or * 
>. > 
L_SUPPRESS ION—name COLOR—colorname 
RGB—rvalue—gvalue—bvalue 
L-HIGHLIGHT—hvalue 
-COVERAGE—cvalue BLACK—bvalue 
CMY K—cvalue—mvalue—yvalue—kvalue 
CIELAB—l value clvalue c2value 
bes pew 
> 7 >< 
BARCODE: 
name. TYPE. | BARCODE Parameters HI 


n 
L-CODE39 (same as 1)—— 
LMSI (same as 2)———— 
L-UPCA (same as 3) 
L-UPCE (same as 5) 
L-UPC2SUPP (same as 6)— 
t-UPC5SUPP (same as 7)—4 
t-EAN8 (same as 8) 
L-EAN13 (same as 9)———J 
L-IND20F5 (same as 10)—4 
L-MAT20F5 (same as 11)—4 
L-ITL20F5 (same as 12)—4 
L-CDB20F7 (same as 13)—4 
L-CODE128 (same as 17)—4 
L-EAN2SUP (same as 22)—4 
L-EAN5SUP (same as 23)—4 
L-POSTNET (same as 24)—4 
L-RM4SCC (same as 26) 
L-JPOSTAL (same as 27)—4 
L-2DMATRIX (same as 28)— 
L-2DMAXI (same as 29)——] 
L-2DPDF417 (same as 30) 
LAPOSTAL (same as 31)— 
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BARCODE Parameters: 


MOD—n | HRI ON SSASTERISK: os HEIGHT—n 
ABOVE HRIFONT—fontname OFF. IN 
BELOW. MM 
OFF: CM 
ONLY POINTS 
L-PELS—} 
>. 
MODWIDTH—n BCCOLOR colorname SUPPBLANKS—! L_RAT I0— ae! 
BLUE 
RED 
L-MAGENTA or PINK: 
GREEN 
L-CYAN or TURQ 
t-YELLOW. 
BLACK: 
BROWN 
MUSTARD: 
DARKBLUE 
L-DARKGREEN: 
L-DARKTURQ or DARKCYAN— 
ORANGE: 
PURPLE. 
}-GRAY: 
NONE. 
DEFAULT. 
>. 
BCXPARMS | 
L size num- rows row-size ID—1—1 | 
MIN BY. SEQUENCE—sqn tot 
Lor _ID—uidHi—uidLo— 
>. 
NOE2A: ESC. MODE—4 SECLV—0 USERDEF- NOZIPPER. | lr] 
E2A. NOESC MODE—and- SECLV—s1 FNC1UCC. ZIPPER | MACRO. qstring. 
FNC1IND: 
RDRPROG 
MAC5: 
-MAC6—— 


The FIELD command identifies a field in a data record or supplies a field of constant text, and positions 
where the field is on the page. More than one position on the page can be specified. 


FIELD commands: 
¢ Are subordinate to a LAYOUT command 
¢ Must follow a LAYOUT command 


The FONT, DIRECTION, and COLOR subcommands do not have fixed defaults. If any of these 
subcommands is omitted, the value for the omitted subcommand is obtained from corresponding 
subcommand in the LAYOUT command. 


Subcommands 
START Specifies the starting byte in the data record for the desired field. 
n Specifies the number of bytes from the first data byte in the record to be used as 


the starting point of the field. The first data byte position of an input record is 1. 


Note: The carriage-control character is not considered data. 


Denotes the next byte after the field identified in the previous FIELD command, 
excluding FIELD commands with constant TEXT. 


If START * was specified in the previous FIELD command, byte 1 is assumed. 
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LENGTH n 


TEXT 


FIELD Command (Record Format) 
+n Adds the value of n to the * byte position. 


-—n Subtracts the value of n from the * byte position. 


If START is omitted and LENGTH is specified, then START * is assumed. 


Specifies the number (n) of bytes to process from the data record, beginning with the 
position specified in START. 


Once the maximum length of the field has been determined, the print server truncates all 
of the fields not containing data. 


Specifies the constant text that is to be printed in the output. A maximum of 65,535 bytes 
of text can be provided in one page format. 


Note: This text is considered constant in that the same text is printed each time. In 
reference to the CONSTANT command within a form definition, this text is 
considered variable because the text prints only where variable data is allowed to 
print. 


duplication = Dn 
Specifies the number of times the text is to be repeated (use a decimal 
number). The maximum times the text is repeated varies depending on the 
size of the text. The default is 1. 


texttype = {CIXIGIK} 
Specifies the type of text. 


C Indicates that the text contains single-byte code characters, which 
includes all Roman alphabetic characters (for example, those used for 
English). Any valid character code can be specified, including blanks. 
This is the default. 


X Indicates that the text contains hexadecimal codes (in groups of two 
hexadecimal codes) that specify values from X'00' through X'FE'. 


G_Indicates that the text contains double-byte code characters (for 
example, kanji characters). 


Characters in type G text must start with shift-out (SO X'OE') and end 
with shift-in (SI X'OF') characters within opening and closing 
apostrophes (X'7D’). 


K __lindicates that the text contains kanji numbers enclosed in 
apostrophes. Kanji numbers are separated by commas: 


K'321,400' 


Valid double-byte character set (DBCS) codes are from X'41' through 
X'FE' for each byte. Code X'4040' (blank) is the only exception. 


Valid: X'4040', X'4041', X'41FE', X'FE41', X'FEFE' 


Invalid: X'2040', X'413E', X'4100', X'7FOO', X'FESE' 


L (m) Specifies the length of text (use a decimal number in parentheses). When 
the actual length of the text is different from m, the m specification is 
honored. That is, the text is either padded with blanks to the right or 
truncated. 


‘tex? Specifies the text. 


Examples: 
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PAGENUM n 


FLDNUM 


RECID 


FONT 


* When TEXT 2C(3)‘AB’ is specified, ‘AB AB ’ is generated. The blanks 
are generated because of the (3) specification. 


* TEXT 2C(1)‘AB’ generates ‘AA’, truncating the Bs. 
Although parameters are specified as optional, at least one must be specified. 


Page numbers could be set at this point to start with the value specified as n, otherwise 
they follow the specification made in the PAGEDEF or PAGEFORMAT command. 


The POSITION parameters specified with the PAGENUM parameter reflects the position 
of the page number only. 


If you do not wish a page number printed, either do not use this parameter or specify 
NOPRINT. 


The RESET parameter is only used when you wish to reset the page number that is to be 
used with this page. 


Note: You should define a font that specifies the font type to be used for printing page 
numbers. 


This keyword should only be used if the DELIMITER field was used in the LAYOUT 
command. Fields cannot be counted without delimiters being specified in the database. 


To allow for the identification of a part of a field which is field delimited, you can specify 
the starting position (from the delimiter), and optionally the length of the part of the field 
you want to use. The LENGTH default is to use the entire remainder of the field from the 
start position to the ending delimiter. 


This keyword allows you to access characters in the first 10 characters of a record. This 
area is reserved for the record identifier, and all other field starts and lengths are 
calculated after this area. These starts and lengths reference only the area within the first 
10 bytes. 


If no record length is specified, the remaining bytes of the 10—byte field is assumed. 


This keyword specifies the the local name of the font to be used for printing the field 
contents. This name must have been previously defined. If this subcommand is not used, 
the print server assigns a font. 


Note: When selecting a font in AIX or Windows NT, you must consider that the text is 
encoded in EBCDIC, not ASCII. Therefore, an EBCDIC font and code page 500 
(also called International #5) must be used . 


ALIGN LEFT | RIGHT 


POSITION 


The data in this field is left or right aligned to the x position specified in the horizontal 
POSITION parameter. 


Specifies the starting position or the alignment position of the field in the printout. 
xX-pos Do not mix x-pos specifications with CURRENT or * except in ACROSS fields. 
- Specifies that the x value is negative. 


Xx Specifies the horizontal offset for the starting print position relative 
to the /ayout starting position. The unit choices are IN, MM, CM, 
POINTS, or PELS. 


The default is the most recent SETUNITS command value or IN 
(inch) if a SETUNITS command has not been issued. 


The PELS measurement equals one L-unit or 1/240 of an inch, 
depending on whether the PELSPERINCH parameter had been 
specified previously. 
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DIRECTION 


SUPPRESSION 


CURRENT 


* 


FIELD Command (Record Format) 


Specifies that the inline offset (relative to the field’s direction) is 
the end of the previous field. For the first field, use the LAYOUT 
offset. This is the default. 


Note: The meaning of CURRENT differs from the meaning of the 
LAYOUT command parameter SAME. 


Alternate for CURRENT. 


y-pos Do not mix y-pos specifications with CURRENT or * except in ACROSS fields. 


y 


NEXT 


CURRENT 


* 


Specifies that the y value is negative. 


Specifies the vertical offset for the starting print position relative to 
the layout starting position. The unit choices are IN, MM, CM, 
POINTS, or PELS. 


The default is the most recent SETUNITS command value or IN 
(inch) if a SETUNITS command has not been issued. 


Specifies a field that is positioned down one line in the baseline 
direction (as defined in the SETUNITS command LINESP 
subcommand) from the previous field. 


Use NEXT only in ACROSS fields. 


Specifies that the baseline offset (relative to the field’s direction) is 
the same as the previous field. That is, the baseline position does 
not change. For the first field, use the LAYOUT offset. This is the 

default. 


Alternate for CURRENT. 


Specifies the print direction of the field, relative to the upper-left corner as you view the 
logical page. If this subcommand is omitted, the direction specified in the governing 
LAYOUT command is used. 


Note: Not all printers can print in all directions. Refer to your printer documentation for 
more information. 


ACROSS The page is printed with the characters added from /eft to right on the 
page, and the lines are added from the top to the bottom. 


DOWN The page is printed with the characters added from top to bottom on the 
page, and the lines added are from the right to the left. 


BACK The page is printed with the characters added from right to left on the 
page, and the lines are added from the bottom to the top. 


UP The page is printed with the characters added from bottom to top on the 
page, and the lines are added from the left to the right. 


Specifies that this text field can be suppressed (text only fields).. 


name Specifies the name of a field to be suppressed. 


Printing of this field is suppressed if this name is identified by a SUPPRESSION command 
within the form definition. 


The same name can be used in one or more fields to suppress these fields as a group. 
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COLOR 


Color Model 


Specifies an OCA or defined color for the text of this field. This subcommand is 
recognized only by printers that support multiple-color printing. Refer to your printer 
publication for more information. 


colorname Values for colorname are NONE, DEFAULT, BLACK, BLUE, BROWN, 
GREEN, PINK, RED, TURQ (turquoise), YELLOW, ORANGE, PURPLE, 
MUSTARD, GRAY, DARKBLUE, DARKGREEN, or DARKTURQ (dark 
turquoise). The color choices depend on the printer. NONE is the color of 
the medium. DEFAULT is the printer default color. 


Note: In some printer publications, the color turquoise (TURQ) is called 
“cyan”, and the color pink (PINK) is called “magenta”. 


PPFA supports the following synonyms: 
¢ CYAN for TURQ 

* DARKCYAN for DARKTURQ 

¢ DBLUE for DARKBLUE 

* DCYAN for DARKTURQ 

¢ DGREEN for DARKGREEN 

¢ DTURQ for DARKTURQ 

* MAGENTA for PINK 


Specifies the color of print for this field supported in MO:DCA for the Red/Green/Blue color 
model (RGB), the highlight color space, the Cyan/Magenta/Yellow/Black color model 
(CMYK), and the CIELAB color model. 


RGB rvalue gvalue bvalue 


Three RGB integer values are used. The first (rva/ue) represents a value for red, the 
second (gvalue) represents a value for green, and the third (bva/ue) represents a value for 
blue. Each of the three integer values may be specified as a percentage from 0 to 100. 


Note: An RGB specification of 0/0/0 is black. An RGB specification of 100/100/100 is 
white. Any other value is a color somewhere between black and white, depending 
on the output device. 


HIGHLIGHT hva/ue COVERAGE cvalue BLACK bvalue 


Indicates the highlight color model. Highlight colors are device dependent, and can be 
specified for the IBM Infoprint HiLite Color Printer Model 4005-HCI. 


You can use an integer within the range of 0 to 65535 for the hvalue. 


Note: An hvalue of 0 indicates that there is no default value defined; therefore, the default 
color of the presentation device is used. 


COVERAGE indicates the amount of coverage of the highlight color to be used. You can 
use an integer within the range of 0 to 100 for the cvalue. If less than 100 percent is 
specified, the remaining coverage is achieved with the color of the medium. 


Note: Fractional values are ignored. If COVERAGE is not specified, a value of 100 is 
used as a default. 


BLACK indicates the percentage of black to be added to the highlight color. You can use 
an integer within the range of 0 to 100 for the bva/ue. The amount of black shading 
applied depends on the COVERAGE percentage, which is applied first. If less than 100 
percent is specified, the remaining coverage is achieved with black. 


Note: If BLACK is not specified, a value of 0 is used as a default. 
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See |“Color on the IBM Infoprint HiLite Color Post Processor’ on page 47|for more 


information. 


CMYK cvalue mvalue yvalue kvalue 


Defines the cyan/magenta/yellow/black color model. cvalue specifies the cyan value. 
mvalue specifies the magenta value. yvalue specifies the yellow value. kvalue specifies 
the black value. You can use an integer percentage within the range of O to 100 for any of 
the CMYK values. 


CIELAB /value (-)c1value (-)c2value 


Defines the CIELAB model. Use a range of 0.00 to 100.00 with /va/lue to specify the 
luminance value. Use signed integers from -—127 to 127 with c1value and c2value to 
specify the chrominance differences. 


Ivalue, c1value, c2value must be specified in this order. There are no defaults for the 
subvalues. 


Note: Do not specify both an OCA color with the COLOR subparameter and an extended 
color model on the same FIELD or LAYOUT command. The output is device 
dependent and may not be what you expect. 


FIELD START 1 LENGTH 5 


FIELD START 1 


COLOR BLUE ; 


LENGTH 1 


RGB 10 75 30 ; 


FIELD START 1 LENGTH 2 


FIELD START 1 


FIELD START 1 


FIELD START 1 


highlight 5 ; 


cmyk 80 10 10 10 ; 


LENGTH 2 


CIELAB 80 100 20 ; 


LENGTH 2 


LENGTH 2 


highlight 300 COVERAGE 50 BLACK 30 ; 


Figure 111. Color Model Usage Using the FIELD Command 


BARCODE 


Specifies a bar code in a page definition. 


The bar code name can be 1-8 characters long. Refer to your printer documentation for 
additional information about bar code support and the SUPPBLANKS subcommand. 
Ensure that the bar code fits on the page or you get errors at print time. 


Please read your printer hardware documentation before using bar codes. The 
documentation indicates which bar code types, modifiers, modwidth, element heights, and 
ratio values are valid for the printer. 


PPFA does minimal verification of the bar code values. If you use the HEIGHT, 
MODWIDTH, RATIO, and BCCOLOR parameters, ensure that the values you specify are 
valid for your printer. 


For printer optimization, specify BARCODE name options in the first instance of a specific 
type of bar code. If this type is used again, position it as usual with START, LENGTH, and 
POSITION, but specify the barcode information using only BARCODE 
same-name-as-previously. The BARCODE subcommand is recognized only by printers 
that support BCOCA bar code printing; refer to Advanced Function Presentation: Printer 
Information (G544-3290) for more information. 


For more information about bar codes, see|Appendix D, “More About Bar Code 


Parameters” on page 395] and refer to Data Stream and Object Architectures: Bar Code 
Object Content Architecture Reference, S544-3766. 
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name Specifies a specific bar code name to be included in a page definition. 
TYPE { nl type-name } 


TYPE 
Specifies the type of bar code symbol to be generated. 


Note: If a type indicates “(same as n)”, you may substitute the number given for the 
character name. 


type-name 
Specifies a specific bar code name to be included in a page definition. 


The following bar code types are supported by PPFA: 


CODE39 (same as 1) 
Specifies a bar code type of Code 39 (8-of-9 code), Automatic Identification 
Manufacturers Uniform Symbol Specification 39. 


MSI (same as 2) 
Specifies a bar code type of modified Plessey code. 


UPCA (same as 3) 
Specifies a bar code type of Universal Product Code (United States) and the 
Canadian Grocery Product Code, Version A 


UPCE (same as 5) 
Specifies a bar code type of Universal Product Code (United States) and the 
Canadian Grocery Product Code, Version E 


UPC2SUPP (same as 6) 
Specifies a bar code type of Universal Product Code (United States) two-digit 
Supplemental (periodicals). 


UPC5SUPP (same as 7) 
Specifies a bar code type of Universal Product Code (United States) five-digit 
Supplemental (paperbacks). 


EAN8 (same as 8) 
Specifies a bar code type of European Article Numbering 8 (includes Japanese 
Article Numbering-short). 


EAN13 (same as 9) 
Specifies a bar code type of European Article Numbering 13 (includes Japanese 
Article Numbering-standard). 


IND2OF5 (same as 10) 
Specifies a bar code type of Industrial 2-of-5. 


MAT2OF5 (same as 11) 
Specifies a bar code type of Matrix 2-of-5. 


ITL2ZOF5 (same as 12) 
Specifies a bar code type of Interleaved 2-of-5, Automatic Identification 
Manufacturers Uniform Symbol Specification-| 2/5. 


CDB20F7 (same as 13) 
Specifies a bar code type of Codabar, 2-of-7, Automatic Identification 
Manufacturers Uniform Symbol Specification-Codabar. 


CODE128 (same as 17) 
Specifies a bar code type of Code 128, Automatic Identification Manufacturers 
Uniform Symbol Specification-128. 
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Note: There is a subset of CODE128 called EAN128. These EAN128 bar codes 
can be produced with PPFA by specifying CODE128 for the bar code type 
in the PAGEDEF and including the extra parts of the bar code in the data. 
The UCC-128 bar code format is: 


startcode FNC1 ai nnnnnnnnnnnnnnnnnn m c stopchar 


The string of ns represents the bar code data. The start code, stop 
character, and 'c' value are generated by the printer microcode for BCOCA 
bar codes. The FNC1 is a hexadecimal 8F character. The “ai” is an 
application identifier and needs to be defined for use by each EAN128 
application. The “m” is a modulo 10 check digit that must be calculated by 
the application and included in the bar code data. 


Not all IBM printers generate the EAN128 bar codes, thus you may need to 
verify that the bar code produced in this manner is readable by your bar 
code scanner. 


For more information about the EAN128 bar codes, visit the Uniform Code 
Council WEB site at http: //www.UC-council.org. 


EAN2SUP (same as 22) 
Specifies a bar code type of European Article Numbering, Two-digit Supplemental. 


EAN5SUB (same as 23) 
Specifies a bar code type of European Article Numbering, Five-digit Supplemental. 


POSTNET (same as 24) 
Specifies a bar code type of POSTal Numeric Encoding Technique (United States 
Postal Service), and defines specific values for the BSD module width, element 
height, height multiplier, and wide-to-narrow ratio fields. 


RM4SCC (same as 26) 
Specifies a 4-state customer code defined by the Royal Mail Postal Service of 
England for bar coding postal code information. 


JPOSTAL (same as 27) 
A complete Japan Postal Bar Code symbol consists of a set of distinct bars and 
spaces for each character followed by a modulo 19 checksum character and 
enclosed by a unique start character, stop character and quiet zones. 


2DMATRIX (same as 28) 
Specifies a Data Matrix two-dimensional bar code. Two-dimensional matrix 
symbologies (sometimes called area symbologies) allow large amounts of 
information to be encoded in a two-dimensional matrix. These symbologies are 
usually rectangular and require a quiet zone around all four sides; for example, the 
Data Matrix symbology requires a quiet zone at least one module wide around the 
symbol. Two-dimensional matrix symbologies use extensive data compaction and 
error correction codes, allowing large amounts of character or binary data to be 
encoded. 


2DMAXI (same as 29) 
Specifies a MaxiCode two-dimensional stacked bar code. Two-dimensional 
stacked symbologies allow large amounts of information to be encoded by 
effectively stacking short one-dimensional symbols in a row/column arrangement. 
This reduces the amount of space that is typically consumed by conventional 
linear bar code symbols and allows for a large variety of rectangular bar code 
shapes. 


2DPDF417 (same as 30) 
Specifies a PDF417 two-dimensional stacked bar code. Two-dimensional stacked 
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symbologies allow large amounts of information to be encoded by effectively 
stacking short one-dimensional symbols in a row/column arrangement. This 
reduces the amount of space that is typically consumed by conventional linear bar 
code symbols and allows for a large variety of rectangular bar code shapes. 


APOSTAL (same as 31) 


Specifies the barcode type as defined by the Australian Postal Service. 


For more information about bar codes, see|Appendix D, “More About Bar Code 


Parameters” on page 395] and refer to Data Stream and Object Architectures: Bar Code 


Object Content Architecture Reference, S544-3766. 


MOD 


HRI 


Specifies additional processing information about the bar code symbol to 
be generated (for example, MOD specifies whether a check-digit'* should 
be generated for the bar code symbol). 


n The meaning of rn differs between the types. For more information, 
see|Table 30 on page 402 


If MOD is not specified, the MOD value defaults as follows, depending on 
the bar code type specified: 


MOD TYPE 
13 
17 
22 
23 
24 
26 
27 
28 
29 
30 
31 


= 
re) 
i=) 


—-~-t = 0 00000 = 
+= OO0C0CCDCODOACAOON + 


Specifies whether the human-readable interpretation (text characters) are 
generated and placed above or below the bar code symbol. 


ON Specifies that HRI should be generated at the default 
location for the barcode type. 

ABOVE Specifies that HRI should be placed above the bar code 
symbol. 

BELOW Specifies that HRI should be placed below the bar code 
symbol. 

OFF Specifies that HRI should not be generated. 

ONLY Specifies that only the HRI is to be printed. No barcode 


symbol is to be generated. The POSITION parameters on 
the FIELD command specify the placement position for 
the first character of the HRI. 


Note: Not all barcode printers honor the request to 
suppress printing the barcode symbol. 


12. Check digits are a method of verifying data integrity during the bar code reading process. 
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FIELD Command (Record Format) 


Note: If HRI is requested, and HRI font isn’t, the printer default font is 
used to render the HRI, instead of the font specified on the FIELD 
FONT subcommand. 


HRIFONT fontname 
Specifies the local name of a font used in printing the HRI for the barcode. 
This font must first be defined in a previous font command in the page 
definition. 


SSASTERISK Specifies whether an asterisk is to be generated as the HRI for bar code 
start and stop characters. 


ON Specifies that start and stop characters should be generated in the 


HRI. 
OFF Specifies that start and stop characters should not be generated in 
the HRI. 
HEIGHT Specifies the height of bar code element. For UPC and EAN bar codes, 


the total height includes the bar code and the HRI characters. 


If HEIGHT is not specified, the printer default height is used. 


Note: HEIGHT is ignored by bar code types that explicitly specify the 
element heights (for example, POSTNET or RM4SCC). 


n Specifies the height of the bar code. 


unit Specifies a unit of measurement for the HEIGHT parameter. The 
choices are IN, MM, CM, POINTS, or PELS. 


Note: If no unit is specified, the default is the most recent 
SETUNITS command value or IN (inch) if a SETUNITS 
command has not been issued. 


MODWIDTH _ Specifies the width of the smallest defined bar code element, using mils 
(thousandths of an inch). For bar code types that explicitly specify the 
module width (for example, POSTNET and RM4SCC), this field is ignored. 
The range of values allowed is 1-254. If MODWIDTH is not specified, the 
printer default MODWIDTH is used. 


n_ Specifies the width of each module, using thousandths of an inch 
(1/1000) as the unit of measurement. 


BCCOLOR Specifies an OCA or defined OCA color to be used in printing the barcode 


and its HRI. 
colorname Specifies the name of a defined color. 
SUPPBLANKS 
Suppress the trailing blanks in the data field used to generate the 
barcode. 
RATIO Specifies the ratio between the width of the wide and the narrow bar code 


elements. The range of values allowed is 100-500, but you must specify a 
value appropriate for your printer and bar code type or you will get errors 
at print time. 


These are extra barcode parameters. They are parameters for the two-dimensional 
barcode types. 


Note: See the Bar Code Object Content Architecture (BCOCA) Reference, S544—3766 for 
more details on these extra parameters. 
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SIZE 


SEQUENCE 


E2A 
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The size of the two-dimensional barcode. The number of rows and size of 

the rows. The allowable values for rows and rowsize are barcode type 

dependent. For Data Matrix two-dimensional barcode there are square 

symbols ranging from 10 by 10 to 144 by 144 and rectangular symbols 

ranging from 8 by 18 to 16 by 48 (rows by row size). See the Bar Code 

Object Content Architecture (BCOCA) Reference, S544—3766 for specific 

allowable sizes. For PDF417 two-dimensional barcode there can be 3 to 

90 rows and 1 to 30 characters per row (row size), but their product 

cannot exceed 928. If size is not coded the default is by type: 

* Data Matrix — Marked as unspecified and the appropriate number of 
rows and row-size are used based on the amount of data. 

¢ MaxiCode — Size is not applicable. 

* PDF417 — MIN number of rows and 10 data symbols per row 
(row-size). 


num-rows The desired number of rows. 


MIN The minimum number of rows necessary to place the 
symbol (for PDF417 only). 


row-size The number of data characters in a row. For Data Matrix 
this includes the finder pattern. 


Structured append sequence indicator. Some two-dimensional barcodes 
can be logically linked together to encode large amounts of data. The 
logically linked symbols can be presented on the same or different media 
and are logically recombined after they are scanned. PPFA checks the 
numbers for obvious errors as well as the proper number range. For 
example, SEQUENCE 5 OF 3 is obviously wrong. 


sqn Structured-append sequence indicator. This parameter is 
an integer whose acceptable range of values is dependent 
on the barcode type. For 2DMATRIX the range is 1 to 16, 
for 2DMAXI it is 1 to 8. For other barcode types the 
parameter is ignored. 


OF Optional parameter for readability. 


tot Total number of structured-append symbols. This 
parameter is an integer whose acceptable range of values 
is dependent on the barcode type. For 2DMATRIX the 
range is 2 to 16, for 2DMAXlI it is 2 to 8. For other 
barcode types the parameter is ignored. 


ID uidHi uidLo The high and low order bytes of a unique file identification 
for a set of structured-append symbols. Each is a unique 
number between 1 and 254 and identifies this set of 
symbols. The actual File ID is computed by 256 times 
uidHi plus uidLo. 


Note: ID, uidHi, and uidLo are required for the Data 
Matrix two-dimensional barcode, is optional for 
MaxiCode, and ignored for PDF417. 


EBCDIC to ASCII translation (used for Data Matrix, MaxiCode, and 
PDF417 two-dimensional barcodes). For Data Matrix and MaxiCode the 
printer converts each byte of the data from EBCDIC codepage 500 to 
ASCII codepage 819. 


For PDF417 the printer converts each byte of the barcode data and each 
byte of the Macro PDF417 control block data from a subset of EBCDIC 
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codepage 500 into ASCII. This translation covers 181 code points which 
includes alphanumerics and many symbols. The code points that are not 
covered by the translation do not occur in EBCDIC and are mapped, by 
the printer, to the X'7F' (127) code point. Do not use the following 
EBCDIC code points for PDF417: 


Table 14. EBCDIC Code Points not used with the E2A Command 


x'04' 
X'1A' 
X'29' 
X'35' 
X'62' 
X'6E' 
X'77' 
X'AC' 
X'BC' 
X'ED' 


X'06' 
X'1B' 
X'2A' 
X'36' 
X'64' 
X'6F' 
X'78' 
X'AD' 
X'BD' 
X'EE' 


X'08' 
X'20' 
X'2B' 
X'38' 
X'65' 
X'70' 
X'80' 
X'AE' 
X'BE' 
X'EF' 


X'09' X'0A' x'14' X'15' X'17' 
X'21' X'22' X'23' xX'24' X'28' 
X'2C' X'30' X'31' X'33' X'34' 
X'39' X'3A' X'3B' X'3E' X'46' 
X'66' X'6A' X'6B' X'6C' X'6D' 
X'72' X'73' X'74' X'75' X'76' 
X'8C' X'8D' X'8E' X'9D' X'9F' 
X'AF' X'B4' X'BS' X'B6' X'B9' 
X'BF' X'CA' X'CF' X'DA' X'EB' 
X'FA' X'FB' X'FD' X'FE' X'FF' 


Note: If you choose this option, have PDF417 Macro data, and are 
running on an ASCII platform (AIX, Windows NT, or Windows 
2000), your PDF417 Macro data is already in ASCII, but the E2A 
command signals the printer to convert the data. A problem occurs 
because the PDF417 Macro data you code is ASCII, the line data 
is EBCDIC, and the printer cannot tell the difference. To avoid this 
problem, PPFA converts the macro data to EBCDIC codepage 500 


by treating the ASCII platform as codepage 819. If any of the data 
code points map to the code points in Table 14 PPFA issues an 
error message and does not generate a page definition. Do not 
use the code points in| Table 15 when coding a PDF417 Macro 
and generating a page definition on an ASCII platform while 
translating EBCDIC to ASCII (E2A): 


Table 15. ASCII Code Points not used with the E2A Command 


X'80' 
X'88' 
X'90' 
X'98' 
X'A6' 
X'B8' 
X'CB' 
X'DD' 


X'81' 
X'89' 
X'91' 
X'99' 
X'A7' 
X'BE' 
X'CC' 
X'DE' 


NOE2A 


ESC 


NOESC 


X'82' 
X'8A' 
X'92' 
X'9A' 
X'A8' 
X'CO' 
X'CD' 
X'E3' 


X'83' X'84' X'85' X'86' X'87' 
X'8B' X'8C' X'8D' X'8E' X'8F' 
X'93' x'94' X'95' X'96' X'97' 
X'9B' x'9C' X'9D' X'9E' X'A4' 
X'AQ' X'AE' X'AF' X'B4' X'B6' 
X'C1' X'C2' X'C3' X'C8' X'CA' 
X'CE' X'CF' X'DO' X'D7' X'D8' 
X'FO' X'F8' X'FD' X'FE' 


No translation. (This is the default if neither is coded. This parameter is 
used for Data Matrix, MaxiCode, and PDF417 two-dimensional barcodes). 
No translation is done by the printer (or by PPFA). The bar code data is 
assumed to in the default encodation (GL10) as defined in the AIM 
Uniform Symbology Specification for PDF417. 


Escape Sequence Handling. This is the default if neither is coded (used 
for Data Matrix, MaxiCode, and PDF417 two-dimensional barcodes). Each 
backslash character within the bar code data is treated as an escape 
character. Note that in this case no code page switching can occur within 
the data. 


Ignore Escape Sequences (used for Data Matrix, MaxiCode, and PDF417 
two-dimensional barcodes). Each backslash character within the bar code 
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MODE 


SECLEV 


data is treated as a normal data character. Note that in this case, no code 
page switching can occur within the data. 


Note: If the EBCDIC to ASCII flag is set (E2A), all EBCDIC backslash 
characters (X'E0') are converted to ASCII (X'5C') before the ESC 
sequence handling flag is applied. 


Symbol mode (used for MaxiCode two-dimensional barcode only). If not 
coded, the default is Standard Symbol Mode 4. 


2 Structured Carrier Message — numeric postal code 

3 Structured Carrier Message — alphanumeric postal code 

4 Standard symbol (default) 

5 not supported 

6 The bar code data is used to program the bar code reader system. 


This parameter specifies the desired security level for the symbol as a 
value from 0 to 8. Each higher security level causes more error correction 
codewords to be added to the symbol (used for PDF417 two-dimensional 
barcode only). If not coded, the default is Security level 0. 


Data Matrix Special Functions 


FNC1UCC 


FNC1IND 


RDRPROG 


MAC5 


MAC6 


USERDEF 


Zipper Pattern 


NOZIPPER 
ZIPPER 
MACRO 
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These are special functions which can only be used with a Data Matrix 
symbol. If not coded, the default is USERDEF (user defined symbol). 


UCC/EAN1 alternate data type identifier. A FNC1 is added in the first data 
position (or fifth position of a structured append symbol) to indicate that 
this bar code symbol conforms to the USS/EAC application identifier 
standard format. 


Industry FNC1 alternate data type identifier. An FNC1 is added in the 
second data position (or sixth data position of a structured append 
symbol) to indicate that this bar code symbol conforms to a particular 
industry standard format. 


Use this when the symbol contains a message used to program the 
barcode reader. In this case the barcode symbol cannot be a part of a 
structured append sequence. 


This provides instructions to the bar code reader to insert an industry 
specific header and trailer around the symbol data. The bar code symbol 
contains a 05 Macro codeword. The barcode symbol cannot be a part of a 
structured append sequence. 


Same as MAC5 except the bar code symbol contains a 06 Macro 
codeword. The barcode symbol cannot be a part of a structured append 
sequence. 


None of the above. This is a user defined data symbol with no Header or 
Trailer instructions to the reader. 


Print a zipper pattern and contrast block (use for MaxiCode 
two-dimensional barcode only) 


Does not print a zipper pattern (default). 
Prints a zipper pattern. 


PDF417 Macro data. The total length of macro text is limited to 2,710 
bytes. This is the maximum number of symbols that can be displayed 


FIELD Command (Record Format) 


using PDF417 symbology and all numbers in the data. This does not 
guarantee that the macro text is not too long if the macro contains other 
than numeric data, characters, or binary data, for example. 


qstring(s) A quoted string. The string does not extend across 
records, but you can code multiple quoted strings. Code 
the MACRO keyword only once. 


Note: The following is a summary of the allowable Barcode Extra Parameters by barcode 
type. Inappropriate parameters are ignored. 
Two-dimensional Data Matrix allows: 


E2AINOE2A 

ESCINOESC 

SIZE num-rows BY row-size (see Bar Code Object Content Architecture 
Reference for allowable sizes) 

SEQUENCE sqn OF tot ID uidHi uidLo (where sqn can be 1 through 16, tot 
can be 2 through 16, and uidHi and uidLo can be 1 through 254) 

Data Matrix Special Functions 


Two-dimensional MaxiCode 


E2AINOE2A 

ESCINOESC 

MODE md (where md is 2 through 6) 

SEQUENCE sqn OF fot (where sqn can be 1 through 8 and fot can be 2 
through 8) 

NOZIPPERIZIPPER 


Two-dimensional PDF417 


E2AINOE2A 

ESCINOESC 

SIZE num-rows BY row-size (num-rows can be 1 to 30 and row-size can be 3 
to 90) 

SECLEV s/ (s/ can be 0 through 8) 

MACRO ‘macro-text’ ‘more-macro-text’ 
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FIELD LENGTH n 
Lstart—n Lo * J FONT—name1 
L, name?! 
| 
TEXT. text’ 
duplication X. L (m) 
G 
Lk 
PAGENUM—NOPRINT—NORESET 
PRINT. NORESET. 
PAGENUM. 
NOPRINT. RESET—n 
START - 1 LENGTH—rest of field 
FLDNUM—n. | | 
START - n LENGTH n 
L 
START - LENGTH— rest of id— 
STAG 
START - n LENGTH——n 
Lx 
START - 1 --LENGTH—rest of attribute 
LA = 
START - n LENGTH n 
bas. al 
ALIGN - LEFT. POSIT ION—CURENT—CURENT- DIRECT ION—ACROSS- 
ALIGN LEFT. POSITION: X pos X pos DIRECTION atl 
LR cuT_ LPOS - LPOS - BACK: 
0 NEXT. LUp— 
LPOS CURRENT or * 
Lx pos 
0 
CPOS 
Ly pos 
APOS—x pos: 
L-CURRENT or * 
SUPPRESS 10N—name COLOR—colorname. 
RGB—rvalue—gvalue—bvalue. 
HIGHLIGHT—hvalue 


OVERAGE—cvalue 


BLACK—bvalue 


Cc 
CMY K—cvalue—mvalue—yvalue—kvalue 
CIELAB—lvalue al clvalue a c2value 
L(-) (-) 
BARCODE. 
name. TYPE. | BARCODE Parameters HW 
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n 
L-CODE39 (same as 


L-UPCA (same as 3) 
L-UPCE (same as 5) 
L-UPC2SUPP (same a 
L-UPC5SUPP (same a 
L-EAN8 (same as 8) 
L-EAN13 (same as 9 
L-IND20F5 (same as 
LMAT20F5 (same 
LITL20F5 (same 
|-CDB20F7 (same 


L-EAN2S 
L-EAN5S 
L-POSTNET 
L-RM4SCC (same as 
L-JPOSTAL (same as 
L-2DMATRIX (same a 
L-2DMAXI (same as 
L-2DPDF417 (same a 
LAPOSTAL (same as 


LMSI (same as 2)———— 


)—_| 


s 6)— 
s 7) 


)—4 


26) — 
27) 
s 28) 
29)— 
s 30) 
31) 
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BARCODE Parameters: 
| 


MOD—n | HRI ON | SSASTERISK: 


ON: HEIGHT—n 
ABOVE HRIFONT—fontname L_orr_ IN 
BELOW. MM 
OFF. CM 
ONLY POINTS 
LPELS—} 
>. > 
MODWIDTH—n BCCOLOR colorname SUPPBLANKS— L_RATIO— Pall 
BLUE 
RED. 
L-MAGENTA or PINK: 
GREEN 
L-CYAN or TURQ 
t-YELLOW. 
BLACK: 
BROWN 
MUSTARD 
DARKBLUE 
L-DARKGREEN: 
L-DARKTURQ or DARKCYAN— 
ORANGE. 
PURPLE 
t-GRAY: 
NONE: 
DEFAULT. 
>. > 
BCXPARMS 
SIZE num- rows row-size ID—1—1 | 
MIN | BY. SEQUENCE—sqn tot 
Lor] “_ID—uidHi—uidLo— 
>. 
NOE2A: ESC MODE—4- SECLV—0. USERDEF NOZIPPER | i 
E2A. NOESC MODE—rnd. SECLV—s1 FNC1UCC ZIPPER MACRO. qstring: 
FNC1LIND. 
RDRPROG 
MAC5. 
“MAC6é—— 


The FIELD command identifies a field in a data record or supplies a field of constant text, and positions 
where the field is on the page. More than one position on the page can be specified. 


FIELD commands: 
¢ Are subordinate to a LAYOUT command 
¢ Must follow a LAYOUT command 


The FONT, DIRECTION, and COLOR subcommands do not have fixed defaults. If any of these 
subcommands is omitted, the value for the omitted subcommand is obtained from corresponding 
subcommand in the LAYOUT command. 


Subcommands 
START Specifies the starting byte in the data record for the desired field. 
n Specifies the number of bytes from the first data byte in the record to be used as 
the starting point of the field. The first data byte position of an input record is 1. 
Note: The carriage-control character is not considered data. 
* Denotes the next byte after the field identified in the previous FIELD command, 


excluding FIELD commands with constant TEXT. 


If START * was specified in the previous FIELD command, byte 1 is assumed. 
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LENGTH n 


TEXT 


+n Adds the value of n to the * byte position. 


-—n Subtracts the value of n from the * byte position. 


If START is omitted and LENGTH is specified, then START * is assumed. 


Specifies the number (n) of bytes to process from the data record, beginning with the 
position specified in START. An asterisk (*) represents the rest of the field. 


Once the maximum length of the field has been determined, the print server then 
truncates all of the fields not containing data. 


Specifies the constant text that is to be printed in the output. A maximum of 65,535 bytes 
of text can be provided in one page format. 


Note: This text is considered constant in that the same text is printed each time. In 
reference to the CONSTANT command within a form definition, this text is 
considered variable because the text prints only where variable data is allowed to 
print. 


duplication = Dn 
Specifies the number of times the text is to be repeated (use a decimal 
number). The maximum times the text is repeated varies depending on the 
size of the text. The default is 1. 


texttype = {CIXIGIK} 
Specifies the type of text. 


C Indicates that the text contains single-byte code characters, which 
includes all Roman alphabetic characters (for example, those used for 
English). Any valid character code can be specified, including blanks. 
This is the default. 


X Indicates that the text contains hexadecimal codes (in groups of two 
hexadecimal codes) that specify values from X'00' through X'FE'. 


G_Indicates that the text contains double-byte code characters (for 
example, kanji characters). 


Characters in type G text must start with shift-out (SO X'0E’) and end 
with shift-in (SI X'OF') characters within opening and closing 
apostrophes (X'7D’). 


K __lindicates that the text contains kanji numbers enclosed in 
apostrophes. Kanji numbers are separated by commas: 


K'321,400' 


Valid double-byte character set (DBCS) codes are from X'41' through 
X'FE' for each byte. Code X'4040' (blank) is the only exception. 


Valid: X'4040', X'4041', X'41FE', X'FE41', X'FEFE' 


Invalid: X'2040', X'413E', X'4100', X'7FO0', X'FESE' 


L (m) Specifies the length of text (use a decimal number in parentheses). When 
the actual length of the text is different from m, the m specification is 
honored. That is, the text is either padded with blanks to the right or 
truncated. 


‘tex? Specifies the text. 


Examples: 
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* When TEXT 2C(8)‘AB’ is specified, ‘AB AB ’ is generated. The blanks 
are generated because of the (3) specification. 


* TEXT 2C(1)‘AB’ generates ‘AA’, truncating the Bs. 


PAGENUM n_ Although parameters are specified as optional, at least one must be specified. 


FLDNUM 


STAG 


ATTR 


FONT 


Page numbers could be set at this point to start with the value specified as n, otherwise 
they follow the specification made in the PAGEDEF or PAGEFORMAT command. 


The POSITION parameters specified with the PAGENUM parameter reflects the position 
of the page number only. 


If you do not wish a page number printed, either do not use this parameter or specify 
NOPRINT. 


The RESET parameter is only used when you wish to reset the page number that is to be 
used with this page. 


Note: You should define a font that specifies the font type to be used for printing page 
numbers. 


This keyword should only be used if the DELIMITER field was used in the LAYOUT 
command. Fields cannot be counted without delimiters being specified in the database. 


To allow for the identification of a part of a field which is field delimited, you can specify 
the starting position (from the delimiter), and optionally the length of the part of the field 
you want to use. The LENGTH default is to use the entire remainder of the field from the 
start position to the ending delimiter. 


LENGTH * means using the remainder of the field for the length. 


This keyword allows you to access characters in the the START tag. It also includes the 
“<” “>” delimiters, so that position 1 is always the “<” delimiter. 


If no record length is specified, the remaining bytes of the START tag is assumed. If no 
START is specified, 1 is assumed. 


LENGTH * means using the remainder of the field for the length. 


This keyword allows you to access attribute values from the data. Multiple attribute fields 
can access the same attribute allowing subsets of the value to be printed. 


If no record length is specified, the remaining bytes of the attribute are assumed. If not 
START is specified, 1 is assumed. 


aname The attribute name. To preserve the case, enter the name in quotes. The 
name is converted to the data type you specify, using UDTYPE on the 
page definition, or it is defaulted. 


START n The starting position of the attribute to extract the data. If this parameter is 
omitted, position 1 is assumed. 


LENGTH n The length of the attribute to be placed. If this parameter is omitted or 
LENGTH * is coded, the rest of the field is assumed for the length. 


This keyword specifies the the local name of the font to be used for printing the field 
contents. This name must have been previously defined. If this subcommand is not used, 
the print server assigns a font. 


Note: When selecting a font in AIX or Windows NT, you must consider that the text is 


encoded in EBCDIC, not ASCII. Therefore, an EBCDIC font and code page 500 
(also called International #5) must be used . 
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ALIGN LEFT | RIGHT 
The data in this field is left or right aligned to the x position specified in the horizontal 
POSITION parameter. 


POSITION 


304 


Notes: 


Specifies the starting position or the alignment position of the field in the printout. 


1. When POSITION is not coded, both the x-position and y-position default to CURRENT. 
2. LPOS in the x-position is not allowed when the x-position of the associated XLAYOUT 


is relative. 


X-position 


y position 


PPFA User’s Guide 


The x-axis or inline positioning parameters. These parameters allow for 
positioning relative both to the containing XLAYOUT (LPOS) and to the 
current position (CPOS and CURRENT). However, positioning relative to 
the XLAYOUT is currently restricted to XLAYOUT commands with 
absolute x positioning. 


LPOS Specifies that this parameter is relative to the XLAYOUT 
position. 


Note: This parameter is not allowed when the associated 
XLAYOUT has relative-x positioning. 


X-pos Optional inline positioning offset. This parameter 
can be negative and when omitted defaults to 0. 


CPOS Specifies that this parameter is relative to the current 
position. 


X-pos Optional inline positioning offset. This parameter 
can be negative and when omitted defaults to 0. 


X pos Specifies the inline positioning of the field in the printout. 
This parameter can be negative and if omitted is defaulted 
to 0. The unit choices are IN, MM, CM, POINTS, or PELS 


APOS Specifies that the x-pos parameter that follows is absolute. 


X-pos Mandatory inline positioning offset. This parameter 
must be positive. 


CURRENT or * 
Specifies that the inline offset (relative to the fields 
direction) is the end of the previous field. For the first field, 
use the XLAYOUT offset. If POSITION is not coded, this 
is the default. 


Note: You can get the same results using the CPOS 
parameter. 


The y-axis or Baseline positioning parameters. These parameters allow for 
positioning relative to both the XLAYOUT (LPOS) position. 


LPOS Specifies that this parameter is relative to the XLAYOUT 
position. This is the default. 


- Specifies that the y value is negative. 


y pos Specifies the vertical offset for the starting print position 
relative to the /ayout starting position. The unit choices are 
IN, MM, CM, POINTS, or PELS. 


DIRECTION 


SUPPRESSION 


COLOR 
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The default is the most recent SETUNITS command value 
or IN (inch) if a SETUNITS command has not been 
issued. 


NEXT Specifies a field that is positioned down one line in the 
baseline direction (as defined in the SETUNITS command 
LINESP subcommand) from the previous field. 


Use NEXT only in ACROSS fields. 


CURRENT Specifies that the baseline offset (relative to the field’s 
direction) is the same as the previous field. That is, the 
baseline position does not change. For the first field, use 
the LAYOUT offset. This is the default. 


bi Alternate for CURRENT. 


Specifies the print direction of the field, relative to the upper-left corner as you view the 
logical page. If this subcommand is omitted, the direction specified in the governing 
LAYOUT command is used. 


Note: Not all printers can print in all directions. Refer to your printer documentation for 
more information. 


ACROSS The page is printed with the characters added from /eft to right on the 
page, and the lines are added from the top to the bottom. 


DOWN The page is printed with the characters added from top to bottom on the 
page, and the lines added are from the right to the left. 


BACK The page is printed with the characters added from right to left on the 
page, and the lines are added from the bottom to the top. 


UP The page is printed with the characters added from bottom to top on the 
page, and the lines are added from the left to the right. 


Specifies that this text field can be suppressed (text only fields).. 


name Specifies the name of a field to be suppressed. 


Printing of this field is suppressed if this name is identified by a SUPPRESSION command 
within the form definition. 


The same name can be used in one or more fields to suppress these fields as a group. 


Specifies an OCA or defined color for the text of this field. This subcommand is 
recognized only by printers that support multiple-color printing. Refer to your printer 
publication for more information. 


colorname Values for colorname are NONE, DEFAULT, BLACK, BLUE, BROWN, 
GREEN, PINK, RED, TURQ (turquoise), YELLOW, ORANGE, PURPLE, 
MUSTARD, GRAY, DARKBLUE, DARKGREEN, or DARKTURQ (dark 
turquoise). The color choices depend on the printer. NONE is the color of 
the medium. DEFAULT is the printer default color. 


Note: In some printer publications, the color turquoise (TURQ) is called 
“cyan”, and the color pink (PINK) is called “magenta”. 


PPFA supports the following synonyms: 


* CYAN for TURQ 
* DARKCYAN for DARKTURQ 
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¢* DBLUE for DARKBLUE 

* DCYAN for DARKTURQ 

* DGREEN for DARKGREEN 
* DTURQ for DARKTURQ 

* MAGENTA for PINK 


Color Model Specifies the color of print for this field supported in MO:DCA for the Red/Green/Blue color 
model (RGB), the highlight color space, the Cyan/Magenta/Yellow/Black color model 
(CMYK), and the CIELAB color model. 


RGB rvalue gvalue bvalue 
Three RGB integer values are used. The first (rva/ue) represents a value for red, the 
second (gvalue) represents a value for green, and the third (bva/ue) represents a value for 
blue. Each of the three integer values may be specified as a percentage from 0 to 100. 


Note: An RGB specification of 0/0/0 is black. An RGB specification of 100/100/100 is 
white. Any other value is a color somewhere between black and white, depending 
on the output device. 


HIGHLIGHT hvalue COVERAGE cva/ue BLACK bvalue 
Indicates the highlight color model. Highlight colors are device dependent, and can be 
specified for the IBM Infoprint HiLite Color Printer Model 4005-HCI. 


You can use an integer within the range of 0 to 65535 for the hvalue. 


Note: An hvalue of 0 indicates that there is no default value defined; therefore, the default 
color of the presentation device is used. 


COVERAGE indicates the amount of coverage of the highlight color to be used. You can 
use an integer within the range of 0 to 100 for the cvalue. If less than 100 percent is 
specified, the remaining coverage is achieved with the color of the medium. 


Note: Fractional values are ignored. If COVERAGE is not specified, a value of 100 is 
used as a default. 


BLACK indicates the percentage of black to be added to the highlight color. You can use 
an integer within the range of 0 to 100 for the bva/ue. The amount of black shading 
applied depends on the COVERAGE percentage, which is applied first. If less than 100 
percent is specified, the remaining coverage is achieved with black. 


Note: If BLACK is not specified, a value of 0 is used as a default. 


See/|“Color on the IBM Infoprint HiLite Color Post Processor” on page 47/for more 


information. 


CMYK cvalue mvalue yvalue kvalue 
Defines the cyan/magenta/yellow/black color model. cvalue specifies the cyan value. 
mvalue specifies the magenta value. yvalue specifies the yellow value. kvalue specifies 
the black value. You can use an integer percentage within the range of O to 100 for any of 
the CMYK values. 


CIELAB /value (-)c1value (-)c2value 
Defines the CIELAB model. Use a range of 0.00 to 100.00 with /value to specify the 
luminance value. Use signed integers from -—127 to 127 with c1value and c2value to 
specify the chrominance differences. 


Ivalue, c1value, c2value must be specified in this order. There are no defaults for the 
subvalues. 
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FIEL 


FIEL 


FIEL 


FIEL 


FIEL 


D START 1 


D START 1 


D START 1 


D START 1 


D START 1 


highlight 5 ; 
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Note: Do not specify both an OCA color with the COLOR subparameter and an extended 
color model on the same FIELD or LAYOUT command. The output is device 
dependent and may not be what you expect. 


D START 1 LENGTH 5 
COLOR BLUE ; 


LENGTH 1 


RGB 10 75 30 ; 


LENGTH 2 


cmyk 80 10 10 10 ; 


LENGTH 2 


CIELAB 80 100 20 ; 


LENGTH 2 


LENGTH 2 


highlight 300 COVERAGE 50 BLACK 30 ; 


Figure 112. Color Model Usage Using the FIELD Command 


BARCODE 


Specifies a bar code in a page definition. 


The bar code name can be 1-8 characters long. Refer to your printer documentation for 
additional information about bar code support and the SUPPBLANKS subcommand. 
Ensure that the bar code fits on the page or you get errors at print time. 


Please read your printer hardware documentation before using bar codes. The 
documentation indicates which bar code types, modifiers, modwidth, element heights, and 
ratio values are valid for the printer. 


PPFA does minimal verification of the bar code values. If you use the HEIGHT, 
MODWIDTH, RATIO, and BCCOLOR parameters, ensure that the values you specify are 
valid for your printer. 


For printer optimization, specify BARCODE name options in the first instance of a specific 
type of bar code. If this type is used again, position it as usual with START, LENGTH, and 
POSITION, but specify the barcode information using only BARCODE 
same-name-as-previously. The BARCODE subcommand is recognized only by printers 
that support BCOCA bar code printing; refer to Advanced Function Presentation: Printer 
Information (G544-3290) for more information. 


For more information about bar codes, see|Appendix D, “More About Bar Code 


Parameters” on page 395] and refer to Data Stream and Object Architectures: Bar Code 
Object Content Architecture Reference, S544-3766. 


TYPE { 11 type-name } 
Specifies the type of bar code symbol to be generated. 
Note: If a type indicates “(same as n)”, you may substitute the number 
given for the character name. 


name 
Specifies a specific bar code name to be included in a page definition. 


TYPE { n1 type-name } 
Specifies a specific bar code name to be included in a page definition. 


The following bar code types are supported by PPFA: 


type-name 
Specifies a specific bar code type name to be included in a page 
definition. 
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CODE39 (same as 1) 
Specifies a bar code type of Code 39 (3-of-9 code), Automatic 
Identification Manufacturers Uniform Symbol Specification 39. 


MSI (same as 2) 
Specifies a bar code type of modified Plessey code. 


UPCA (same as 3) 
Specifies a bar code type of Universal Product Code (United 
States) and the Canadian Grocery Product Code, Version A 


UPCE (same as 5) 
Specifies a bar code type of Universal Product Code (United 
States) and the Canadian Grocery Product Code, Version E 


UPC2SUPP (same as 6) 
Specifies a bar code type of Universal Product Code (United 
States) two-digit Supplemental (periodicals). 


UPC5SUPP (same as 7) 
Specifies a bar code type of Universal Product Code (United 
States) five-digit Supplemental (paperbacks). 


EAN8 (same as 8) 
Specifies a bar code type of European Article Numbering 8 
(includes Japanese Article Numbering-short). 


EAN13 (same as 9) 
Specifies a bar code type of European Article Numbering 13 
(includes Japanese Article Numbering-standard). 


IND2OF5 (same as 10) 
Specifies a bar code type of Industrial 2-of-5. 


MAT2OF5 (same as 11) 
Specifies a bar code type of Matrix 2-of-5. 


ITL2OF5 (same as 12) 
Specifies a bar code type of Interleaved 2-of-5, Automatic 
Identification Manufacturers Uniform Symbol Specification-| 2/5. 


CDB20F7 (same as 13) 
Specifies a bar code type of Codabar, 2-of-7, Automatic 
Identification Manufacturers Uniform Symbol Specification- 
Codabar. 


CODE128 (same as 17) 
Specifies a bar code type of Code 128, Automatic Identification 
Manufacturers Uniform Symbol Specification-128. 


Note: There is a subset of CODE128 called EAN128. These 
EAN128 bar codes can be produced with PPFA by 
specifying CODE128 for the bar code type in the 
PAGEDEF and including the extra parts of the bar code in 
the data. The UCC-128 bar code format is: 


startcode FNC1 ai nnnnnnnnnnnnnnnnnn m c stopchar 


The string of ns represents the bar code data. The start 
code, stop character, and 'c' value are generated by the 
printer microcode for BCOCA bar codes. The FNC1 is a 
hexadecimal 8F character. The “ai” is an application 
identifier and needs to be defined for use by each EAN128 
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application. The “m” is a modulo 10 check digit that must 
be calculated by the application and included in the bar 
code data. 


Not all IBM printers generate the EAN128 bar codes, thus 
you may need to verify that the bar code produced in this 
manner is readable by your bar code scanner. 


For more information about the EAN128 bar codes, visit the 
Uniform Code Council WEB site at http: //www.UC- 
council.org. 


EAN2SUP (same as 22) 
Specifies a bar code type of European Article Numbering, 
Two-digit Supplemental. 


EAN5SUB (same as 23) 
Specifies a bar code type of European Article Numbering, 
Five-digit Supplemental. 


POSTNET (same as 24) 
Specifies a bar code type of POSTal Numeric Encoding Technique 
(United States Postal Service), and defines specific values for the 
BSD module width, element height, height multiplier, and 
wide-to-narrow ratio fields. 


RM4SCC (same as 26) 
Specifies a 4-state customer code defined by the Royal Mail 
Postal Service of England for bar coding postal code information. 


JPOSTAL (same as 27) 
A complete Japan Postal Bar Code symbol consists of a set of 
distinct bars and spaces for each character followed by a modulo 
19 checksum character and enclosed by a unique start character, 
stop character and quiet zones. 


2DMATRIX (same as 28) 
Specifies a Data Matrix two-dimensional bar code. 
Two-dimensional matrix symbologies (sometimes called area 
symbologies) allow large amounts of information to be encoded in 
a two-dimensional matrix. These symbologies are usually 
rectangular and require a quiet zone around all four sides; for 
example, the Data Matrix symbology requires a quiet zone at least 
one module wide around the symbol. Two-dimensional matrix 
symbologies use extensive data compaction and error correction 
codes, allowing large amounts of character or binary data to be 
encoded. 


2DMAXI (same as 29) 
Specifies a MaxiCode two-dimensional stacked bar code. 
Two-dimensional stacked symbologies allow large amounts of 
information to be encoded by effectively stacking short 
one-dimensional symbols in a row/column arrangement. This 
reduces the amount of space that is typically consumed by 
conventional linear bar code symbols and allows for a large variety 
of rectangular bar code shapes. 


2DPDF417 (same as 30) 
Specifies a PDF417 two-dimensional stacked bar code. 
Two-dimensional stacked symbologies allow large amounts of 
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information to be encoded by effectively stacking short 
one-dimensional symbols in a row/column arrangement. This 
reduces the amount of space that is typically consumed by 
conventional linear bar code symbols and allows for a large variety 
of rectangular bar code shapes. 


APOSTAL (same as 31) 
Specifies the barcode type as defined by the Australian Postal 


Service. 


For more information about bar codes, see|Appendix D, “More About Ba 


Code Parameters” on page 395] and refer to Data Stream and Object 
Architectures: Bar Code Object Content Architecture Reference, 


$544-3766. 


MOD 


HRI 


=3a300000OA=-6 


iw] 


Specifies additional processing information about the bar 
code symbol to be generated (for example, MOD specifies 
whether a check-digit'* should be generated for the bar 
code symbol). 


n The meaning of n differs between the types. For more 


information, see|Table 30 on page 402 


If MOD is not specified, the MOD value defaults as 
follows, depending on the bar code type specified: 


TYPE 
13 
17 
22 
23 
24 
26 
27 
28 
29 
30 
31 


= 
re) 
i=) 


=O 000000 0NDR— 


Specifies whether the human-readable interpretation (text 
characters) are generated and placed above or below the 
bar code symbol. 


ON Specifies that HRI should be generated at 
the default location for the barcode type. 

ABOVE Specifies that HRI should be placed above 
the bar code symbol. 

BELOW Specifies that HRI should be placed below 
the bar code symbol. 

OFF Specifies that HRI should not be 
generated. 

ONLY Specifies that only the HRI is to be 


printed. No barcode symbol is to be 


13. Check digits are a method of verifying data integrity during the bar code reading process. 
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generated. The POSITION parameters on 
the FIELD command specify the 
placement position for the first character 
of the HRI. 


Note: Not all barcode printers honor the 
request to suppress printing the 
barcode symbol. 


Note: If HRI is requested, and HRI font isn’t, the printer 
default font is used to render the HRI, instead of 
the font specified on the FIELD FONT 
subcommand. 


HRIFONT fontname 


SSASTERISK 


HEIGHT 


MODWIDTH 


Specifies the local name of a font used in printing the HRI 
for the barcode. This font must first be defined in a 
previous FONT command in the page definition. 


Specifies whether an asterisk is to be generated as the 
HRI for bar code start and stop characters. 


ON Specifies that start and stop characters should be 
generated in the HRI. 


OFF Specifies that start and stop characters should not 
be generated in the HRI. 


Specifies the height of bar code element. For UPC and 
EAN bar codes, the total height includes the bar code and 
the HRI characters. 


If HEIGHT is not specified, the printer default height is 
used. 


Note: HEIGHT is ignored by bar code types that explicitly 
specify the element heights (for example, 
POSTNET or RM4SCC). 


n Specifies the height of the bar code. 


unit Specifies a unit of measurement for the HEIGHT 
parameter. The choices are IN, MM, CM, POINTS, 
or PELS. 


Note: If no unit is specified, the default is the 
most recent SETUNITS command value or 
IN (inch) if a SETUNITS command has not 
been issued. 


Specifies the width of the smallest defined bar code 
element, using mils (thousandths of an inch). For bar code 
types that explicitly specify the module width (for example, 
POSTNET and RM4SCC), this field is ignored. The range 
of values allowed is 1-254. If MODWIDTH is not specified, 
the printer default MODWIDTH is used. 


n_ Specifies the width of each module, using 
thousandths of an inch (1/1000) as the unit of 
measurement. 
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BCCOLOR 


SUPPBLANKS 


RATIO 


Specifies an OCA or defined OCA color to be used in 
printing the barcode and its HRI. 


colorname Specifies the name of a defined color. 


Suppress the trailing blanks in the data field used to 
generate the barcode. 


Specifies the ratio between the width of the wide and the 
narrow bar code elements. The range of values allowed is 
100-500, but you must specify a value appropriate for your 
printer and bar code type or you get errors at print time. 


These are extra barcode parameters. They are parameters for the 2 
dimensional barcode types. 


Note: See the Bar Code Object Content Architecture (BCOCA) 
Reference, S544—3766 for more details on these extra parameters. 


SIZE 


SEQUENCE 


The size of the two-dimensional barcode. The number of 
rows and size of the rows. The allowable values for rows 
and rowsize are barcode type dependent. For Data Matrix 
two-dimensional barcode there are square symbols 
ranging from 10 by 10 to 144 by 144 and rectangular 
symbols ranging from 8 by 18 to 16 by 48 (rows by row 
size). See the Bar Code Object Content Architecture 
(BCOCA) Reference, S544—3766 for specific allowable 
sizes. For PDF417 two-dimensional barcode there can be 
3 to 90 rows and 1 to 30 characters per row (row size), 
but their product cannot exceed 928. If size is not coded 
the default is by type: 
¢ Data Matrix — Marked as unspecified and the 
appropriate number of rows and row-size are used 
based on the amount of data. 
¢ MaxiCode — Size is not applicable. 
¢ PDF417 — MIN number of rows and 10 data symbols 
per row (row-size). 


num-rows The desired number of rows. 

MIN The minimum number of rows necessary 
to place the symbol (for PDF417 only). 

row-size The number of data characters in a row. 
For Data Matrix this includes the finder 
pattern. 


Structured append sequence indicator. Some 
two-dimensional barcodes can be logically linked together 
to encode large amounts of data. The logically linked 
symbols can be presented on the same or different media 
and are logically recombined after they are scanned. 
PPFA checks the numbers for obvious errors as well as 
the proper number range. For example, SEQUENCE 5 OF 
3 is obviously wrong. 


sqn Structured-append sequence indicator. 
This parameter is an integer whose 
acceptable range of values is dependent 
on the barcode type. For 2DMATRIX the 


E2A 
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range is 1 to 16, for 2DMAXlI it is 1 to 8. 
For other barcode types the parameter is 


ignored. 
OF Optional parameter for readability. 
tot Total number of structured-append 


symbols. This parameter is an integer 
whose acceptable range of values is 
dependent on the barcode type. For 
2DMATRIX the range is 2 to 16, for 
2DMAXL it is 2 to 8. For other barcode 
types the parameter is ignored. 


ID uidHi uidLo The high and low order bytes of a unique 
file identification for a set of 
structured-append symbols. Each is a 
unique number between 1 and 254 and 
identifies this set of symbols. The actual 
File ID is computed by 256 times uidHi 
plus uidLo. 


Note: ID, uidHi, and uidLo are required 
for the Data Matrix two-dimensional 
barcode, is optional for MaxiCode, 
and ignored for PDF417. 


EBCDIC to ASCII translation (used for Data Matrix, 
MaxiCode, and PDF417 two-dimensional barcodes). For 
Data Matrix and MaxiCode the printer converts each byte 
of the data from EBCDIC codepage 500 to ASCII 
codepage 819. 


For PDF417 the printer converts each byte of the barcode 
data and each byte of the Macro PDF417 control block 
data from a subset of EBCDIC codepage 500 into ASCII. 
This translation covers 181 code points which includes 
alphanumerics and many symbols. The code points that 
are not covered by the translation do not occur in 
EBCDIC and are mapped, by the printer, to the X'7F' (127) 
code point. Do not use the following EBCDIC code 
points for PDF417: 


Table 16. EBCDIC Code Points not used with the E2A Command 


x'04' 
X'1A' 
X'29' 
X'35' 
X'62' 
X'6E' 
X'77' 
X'AC' 
X'BC' 
X'ED' 


X'06' 
X'1B' 
X'2A' 
X'36' 
X'64' 
X'6F' 
X'78' 
X'AD' 
X'BD' 
X'EE' 


X'08' 
X'20' 
X'2B' 
X'38' 
X'65' 
X'70' 
X'80' 
X'AE' 
X'BE' 
X'EF' 


X'09' 
X'21' 
X'2C' 
X'39' 
X'66' 
X'72' 
X'8C' 
X'AF' 
X'BF' 
X'FA' 


X'0A' xX'14' X'15' X'17' 
X'22' X'23' xX'24' X'28' 
X'30' X'31' X'33' X'34' 
X'3A' X'3B' X'3E' X'46' 
X'6A' X'6B' X'6C' X'6D' 
X'73' X'74' X'75' X'76' 
X'8D' X'8E' X'9D' X'9F' 
X'B4' X'BS' X'B6' X'B9' 
X'CA' X'CF' X'DA' X'EB' 
X'FB' X'FD' X'FE' X'FF' 


Note: If you choose this option, have PDF417 Macro 
data, and are running on an ASCII platform (AIX, 
Windows NT, or Windows 2000), your PDF417 
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Macro data is already in ASCII, but the E2A 
command signals the printer to convert the data. A 
problem occurs because the PDF417 Macro data 
you code is ASCII, the line data is EBCDIC, and 
the printer cannot tell the difference. To avoid this 
problem, PPFA converts the macro data to EBCDIC 
codepage 500 by treating the ASCII platform as 
codepage 819. If any_of the data code points map 
to the code points inflable 16 on page 314] PFA 
issues an error message and does not generate a 
page definition. Do not use the code points in 
when coding a PDF417 Macro and 
generating a page definition on an ASCII 
platform while translating EBCDIC to ASCII 


Table 17. ASCII Code Points not used with the E2A Command 


X'80' 
X'88' 
X'90' 
X'98' 
X'A6' 
X'B8' 
X'CB' 
X'DD' 
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X'81' 
X'89' 
X'91' 
X'99' 
X'A7' 
X'BE' 
X'CC' 
X'DE' 
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X'82' 
X'8A' 
X'92' 
X'9A' 
X'A8' 
X'CO' 
X'CD' 
X'E3' 


NOE2A 


ESC 


NOESC 


MODE 


X'83' 
X'8B' 
X'93' 
X'9B' 
X'AQ' 
X'C1' 
X'CE' 
X'FO' 


(E2A): 

X'84' X'85' X'86' X'87' 
X'8C' X'8D' X'8E' X'8F' 
x'94' X'95' X'96' X'97' 
X'9C' X'9D' X'9E' X'A4 
X'AE' X'AF' X'B4' X'B6' 
X'C2' X'C3' X'C8' X'CA' 
X'CF' X'DO' X'D7' X'D8' 
X'F8' X'FD' X'FE' 


No translation. (This is the default if neither is coded. This 
parameter is used for Data Matrix, MaxiCode, and 
PDF417 two-dimensional barcodes). No translation is 
done by the printer (or by PPFA). The bar code data is 
assumed to in the default encodation (GL10) as defined in 
the AIM Uniform Symbology Specification for PDF417. 


Escape Sequence Handling. This is the default if neither is 
coded (used for Data Matrix, MaxiCode, and PDF417 
two-dimensional barcodes). Each backslash character 
within the bar code data is treated as an escape 
character. Note that in this case no code page switching 
can occur within the data. 


Ignore Escape Sequences (used for Data Matrix, 
MaxiCode, and PDF417 two-dimensional barcodes). Each 
backslash character within the bar code data is treated as 
a normal data character. Note that in this case, no code 
page switching can occur within the data. 


Note: If the EBCDIC to ASCII flag is set (E2A), all 
EBCDIC backslash characters (X'E0') are 
converted to ASCII (X'5C') before the ESC 
sequence handling flag is applied. 


Symbol mode (used for MaxiCode two-dimensional 
barcode only). If not coded, the default is Standard 
Symbol Mode 4. 


2 Structured Carrier Message — numeric postal code 


3 Structured Carrier Message — alphanumeric postal 
code 


SECLEV 
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4 Standard symbol (default) 
5 not supported 
6 The bar code data is used to program the bar code 


reader system. 


This parameter specifies the desired security level for the 
symbol as a value from 0 to 8. Each higher security level 
causes more error correction codewords to be added to 
the symbol (used for PDF417 two-dimensional barcode 
only). If not coded, the default is Security level 0. 


Data Matrix Special Functions 


FNC1UCC 


FNC1IND 


RDRPROG 


MAC5 


MAC6 


USERDEF 
Zipper Pattern 
NOZIPPER 


ZIPPER 
MACRO 


These are special functions which can only be used with a 
Data Matrix symbol. If not coded, the default is USERDEF 
(user defined symbol). 


UCC/EAN1 alternate data type identifier. A FNC1 is added 
in the first data position (or fifth position of a structured 
append symbol) to indicate that this bar code symbol 
conforms to the USS/EAC application identifier standard 
format. 


Industry FNC1 alternate data type identifier. An FNC1 is 
added in the second data position (or sixth data position of 
a structured append symbol) to indicate that this bar code 
symbol conforms to a particular industry standard format. 


Use this when the symbol contains a message used to 
program the barcode reader. In this case the barcode 
symbol cannot be a part of a structured append sequence. 


This provides instructions to the bar code reader to insert 
an industry specific header and trailer around the symbol 
data. The bar code symbol contains a 05 Macro 
codeword. The barcode symbol cannot be a part of a 
structured append sequence. 


Same as MAC5 except the bar code symbol contains a 06 
Macro codeword. The barcode symbol cannot be a part of 
a structured append sequence. 


None of the above. This is a user defined data symbol 
with no Header or Trailer instructions to the reader. 


Print a zipper pattern and contrast block (use for 
MaxiCode two-dimensional barcode only) 


Does not print a zipper pattern (default). 
Prints a zipper pattern. 


PDF417 Macro data. The total length of macro text is 
limited to 2,710 bytes. This is the maximum number of 
symbols that can be displayed using PDF417 symbology 
and all numbers in the data. This does not guarantee that 
the macro text is not too long if the macro contains other 
than numeric data, characters, or binary data, for example. 


qgstring(s) A quoted string. The string does not 
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extend across records, but you can code 
multiple quoted strings. Code the MACRO 
keyword only once. 


Note: The following is a summary of the allowable Barcode Extra Parameters by barcode 
type. Inappropriate parameters are ignored. 
Two-dimensional Data Matrix allows: 
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E2AINOE2A 

ESCINOESC 

SIZE num-rows BY row-size (see Bar Code Object Content Architecture 
Reference for allowable sizes) 

SEQUENCE sgn OF fot ID uidHi uidLo (where sqn can be 1 through 16, tot 
can be 2 through 16, and uidHi and uidLo can be 1 through 254) 

Data Matrix Special Functions 


Two-dimensional MaxiCode 


E2AINOE2A 

ESCINOESC 

MODE md (where md is 2 through 6) 

SEQUENCE sgn OF tot (where sqn can be 1 through 8 and fot can be 2 
through 8) 

NOZIPPERIZIPPER 


Two-dimensional PDF417 


E2AINOE2A 

ESCINOESC 

SIZE num-rows BY row-size (num-rows can be 1 to 30 and row-size can be 3 
to 90) 

SECLEV s/ (s/ can be 0 through 8) 

MACRO ‘macro-text’ ‘more-macro-text’ 


FONT Command (Record Format) 
FONT Command (Record Format) 


FONT Command 


ake 
>>—FONT c fname > 
sneha | pecs --POINTS 

t-Lname—'cfname ' HEIGHT—n 
t-Lname—CS—character set name—CP—code page name— t-IN 
'—_Iname—GRID—hex grid t-CM 

LMM 

L-PELS 

TYPE—EBCDIC --ROTATION—O 


UNICODE [-18 
270 


dean eer I Leatio—percen ra ee Lacey 
0 


<4 


7 a 
RES——240 


300 | | METTECH FIXED | 
L ReLaTive— 


The FONT command is used to identify the fonts that are to be specified in the LAYOUT and FIELD 
commands. A maximum of 127 font names for each page definition can be identified. 


Note: Naming a font with the FONT command does not, by itself, affect your output. You must specify the 
font in a LAYOUT or FIELD command for the font to become effective. If you do not name a font, 
the default font is used. 


FONT commands immediately follow the PAGEDEF command. A separate FONT command is required: 
* For each font used within a page definition 
¢ For each rotation of the same font 


FONT Identifies the fonts to be specified in the LAYOUT and FIELD commands. 


Iname Specifies an alphanumeric name of 1 to 16 characters (local name) of the 
font to be used in this page definition. The name must conform to the 
token rules and must be unique within this page definition. 


Iname is used in the FIELD and LAYOUT commands of a page definition. 
Iname is optional if cfname is specified and not quoted. 


cfname Specifies an alphanumeric name of 1 to 16 characters (user-access name) 
of the coded font to be used in this page definition. Specify this name 
without the Xn prefix. 


‘cfname' Quoted full user-access name. Specifies a quoted alphanumeric name of 
1 to 8 characters of the coded font to be used in this page definition. The 
name can contain blanks and special characters. No upper case folding or 
prefix is added to the name. The 'cfname' variable is intended for outline 
fonts and allows them to be selected without overriding the HEIGHT 
specification in the font. Enter the full outline font name as a quoted name 
and do not enter the HEIGHT parameter. For example, if you enter: 


FONT myfont 'XZM32F' 
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the outline font XZM32F is used with no overriding HEIGHT parameters 
used. 


Notes: 


1. The quoted name of the font name is primarily intended for outline 
fonts. If you use a quoted name for a raster font, you must be sure 
that you have the name corresponding to the correct rotation of the 
font. 


2. If you use the quoted name of the font name, you must also enter an 
Iname (local name); sometimes called an “alias name”. 


3. You can still specify the HEIGHT command if you want and override 
the coded font height. 


character-set-name 
Specifies an alphanumeric name of 1 to 6 characters of the character set 
to be used in this page definition. Specify this name without the Cn prefix. 


code-page-name 
Specifies an alphanumeric name of 1 to 6 characters of the code page to 
be used in this page definition. 


hex-grid Specifies the 16-character hexadecimal GRID. 


Subcommands 
SBCS or DBCS 


HEIGHT n 


TYPE 


RATIO 


ROTATION 


Specifies single-byte or double-byte fonts. 
SBCS Specifies that the font is a single-byte character set. This is the default. 
DBCS Specifies that the font is a double-byte character set. 


Specifies the height of the outline font. 


POINTS Each point is equal to 1/72 of one inch. 

IN Inches 

CM Centimeters 

MM Millimeters 

PELS Pels in the current Logical Unit per inch. For example in 240ths of an inch. 


The TYPE subcommand indicates the type of Font being used. 


EBCDIC This parameter is normally used for fonts on OS390—based systems. This 
is the default. 


ASCII This parameter is normally used for fonts on workstation—based systems. 
UNICODE This parameter is used with Unicode type fonts. 
Specifies the ratio of scaling the width relative to the height in an outline font. 


percent Represents the percent of the “normal” width of the character that is 
printed. For example, specifying RATIO 50 yields a font with characters 
half as wide as normal, and specifying RATIO 200 yields a font with 
characters twice as wide (200% as wide) as normal. If RATIO is specified, 
you must also specify the HEIGHT. 


Specifies the rotation of characters in degrees. The specified value is relative to the inline 
direction of a layout or field. Valid rotations are 0°, 90°, 180°, or 270°; 0° is the default. 


RESOLUTION Specifies the resolution and metric technology on a font. 
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RES or RESOLUTION 
The raster-pattern resolution units in pels per inch 
240 240 pels per inch 
300 300 pels per inch 
METTECH or METRICTECHNOLOGY 
The metric technology used for this raster font 
FIXED Fixed-metric technology 
RELATIVE Relative-metric technology 
Notes: 


1. The resolution and metrictechnology subcommands allow rigorous font specifications 
for use with font fidelity. See the font fidelity subcommand FONTFID on the FORMDEF 
command. 


2. Fora description of metric technologies, refer to: 
¢ Intelligent Printer Data Stream Reference, S544-3417 
¢ Font Object Content Architecture Reference, S544-3285 


3. RESOLUTION can be abbreviated as RES; METRICTECHNOLOGY can be 
abbreviated as METTECH. 


FORMDEF xmpQ1 
FONTFID YES ; 


PAGEDEF xmp01 replace yes ; 
FONT xx2 res 240 mettech fixed ; 
LAYOUT font xx2 ; 


Figure 113. Example of PPFA Support for Font Fidelity 


In the example above, the form definition xmp01 specifies font fidelity and the page 
definition specifies a font that has 240 pels per inch resolution and fixed-metric technology. 
If a font with exactly those characteristics is not accessible by the printer, an error occurs 
and processing stops. 
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FONT Command 


ica 
>>—FONT z c fname a] 

‘_I name DBCS POINTS 
t-Lname—'cfname ' HEIGHT—n 
t-Lname—CS—character set name—CP—code page name— IN 
'—_Iname—GRID—hex grid CM 

MM 
L_PELS 


>—TYPE EBCDIC L 7 
Hast i RATIO—percent “ROTATION—-—90 


--ROTAT ION—O 


UNICODE -120-] 
270. 


300 | wETTECH—-F1xe0—_ 
RELATIVE 


The FONT command is used to identify the fonts that are to be specified in the XLAYOUT and FIELD 
commands. A maximum of 127 font names for each page definition can be identified. 


Notes: 


ie 


Naming a font with the FONT command does not, by itself, affect your output. You must specify the 


| 


font in a XLAYOUT or FIELD or commands for the font to become effective. If you do not name a font, 


the default font is used. 


Prior to adding the XML data support to page definitions, PPFA assumed that the font encoding and 
the data encoding were single byte EBCDIC, and translated the text to EBCDIC if necessary (if PPFA 
is invoked on an ASCII system). PPFA allowed the font encoding to be specified, but it was used only 
for generating page numbers for record formatting page definitions. 


Page definitions that support XML data must specify the font encoding and it are used to translate the 
text if it differs from the date encoding. The data encoding is specified on the PAGEDEF command 
using the UDType subcommand. When the font encoding does not agree with the data encoding, the 
data must be transformed to match that of the font. PPFA passes that information to the printer (or 
other presentation device) and that device must do the transformation. Only the following 
transformations are allowed and then only if they are supported by the presentation device: 


¢ UDType UTF-8, font type can only be ASCII or UNICODE 
¢ UDType UTF-16, font type can only be UNICODE. 


If the font type differs from the User Data Type and it is any other combination, PPFA issues an error 
message and no page definition is created. 


FONT commands immediately follow the PAGEDEF command. A separate FONT command is required: 


For each font used within a page definition 
For each rotation of the same font 


320 = PPFA User's Guide 


FONT Command (XML) 


Identifies the fonts to be specified in the XLAYOUT and FIELD commands. 


Specifies an alphanumeric name of 1 to 16 characters (local name) of the 
font to be used in this page definition. The name must conform to the 
token rules and must be unique within this page definition. 


Iname is used in the XLAYOUT and FIELD commands of a page 
definition. 


Iname is optional if cfname is specified and not quoted. 


Specifies an alphanumeric name of 1 to 6 characters (user-access name) 
of the coded font to be used in this page definition. Specify this without 
the Xn prefix. 


Quoted full user-access name. Specifies a quoted alphanumeric name of 
1 to 8 characters of the coded font to be used in this page definition. The 
name can contain blanks and special characters. No upper case folding or 
prefix is added to the name. The 'cfname' variable is intended for outline 
fonts and allows them to be selected without overriding the HEIGHT 
specification in the font. Enter the full outline font name as a quoted name 
and do not enter the HEIGHT parameter. For example, if you enter: 


FONT myfont 'XZM32F' 


the outline font XZM32F is used with no overriding HEIGHT parameters 
used. 


Notes: 


1. The quoted name of the font name is primarily intended for outline 
fonts. If you use a quoted name for a raster font, you must be sure 
that you have the name corresponding to the correct rotation of the 
font. 


2. If you use the quoted name of the font name, you must also enter an 
Iname (local name); sometimes called an “alias name”. 

3. You can still specify the HEIGHT command if you want and override 
the coded font height. 


character-set-name 


Specifies an alphanumeric name of 1 to 6 characters of the character set 
to be used in this page definition. Specify this without the Cn prefix. 


code-page-name 


FONT 
Iname 
cfname 
‘cfname' 
hex-grid 
Subcommands 


SBCS or DBCS 


Specifies an alphanumeric name of 1 to 6 characters of the code page to 
be used in this page definition. 


Specifies the 16-character hexadecimal GRID. 


Specifies single-byte or double-byte fonts. 


SBCS Specifies that the font is a single-byte character set. This is the default. 


HEIGHT n 


DBCS Specifies that the font is a double-byte character set. 


Specifies the height of the outline font. 


POINTS 
IN 


CM 


Each point is equal to 1/72 of one inch. 
Inches 


Centimeters 
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TYPE 


RATIO 


ROTATION 


RESOLUTION 


MM Millimeters 
PELS Pels in the current Logical Unit per inch. For example in 240ths of an inch. 


The TYPE subcommand indicates the type of Font being used. This parameter is required 
for fonts in an XML page definition. 


EBCDIC This parameter is normally used for fonts on OS390-based systems. 
ASCII This parameter is normally used for fonts on workstation—based systems. 


UNICODE This parameter is used with Unicode type fonts (fixed two-byte UNICODE 
without surrogates. 


Specifies the ratio of scaling the width relative to the height in an outline font. 


percent Represents the percent of the “normal” width of the character that is 
printed. For example, specifying RATIO 50 yields a font with characters 
half as wide as normal, and specifying RATIO 200 yields a font with 
characters twice as wide (200% as wide) as normal. If RATIO is specified, 
you must also specify the HEIGHT. 


Specifies the rotation of characters in degrees. The specified value is relative to the inline 
direction of a layout or field. Valid rotations are 0°, 90°, 180°, or 270°; 0° is the default. 


Specifies the resolution and metric technology on a font. 
RES or RESOLUTION 
The raster-pattern resolution units in pels per inch 


240 240 pels per inch 
300 300 pels per inch 


METTECH or METRICTECHNOLOGY 
The metric technology used for this raster font 


FIXED Fixed-metric technology 
RELATIVE Relative-metric technology 


Notes: 


1. The resolution and metrictechnology subcommands allow rigorous font specifications 
for use with font fidelity. See the font fidelity subcommand FONTFID on the FORMDEF 
command. 


2. For a description of metric technologies, refer to: 
¢ Intelligent Printer Data Stream Reference, S544-3417 
* Font Object Content Architecture Reference, S544-3285 


3. RESOLUTION can be abbreviated as RES; METRICTECHNOLOGY can be 
abbreviated as METTECH. 


FORMDEF xmp01 


FONTFID 


PAGEDEF 


VES. 3 


xmp01 replace yes ; 


FONT xx2 res 240 mettech fixed ; 
LAYOUT font xx2 3; 


Figure 114. Example of PPFA Support for Font Fidelity 


In the example above, the form definition xmp01 specifies font fidelity and the page 
definition specifies a font that has 240 pels per inch resolution and fixed-metric technology. 
If a font with exactly those characteristics is not accessible by the printer, an error occurs 
and processing stops. 
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>< 


LAYOUT Command 
>>— LAYOUT. DEFAULT. 
Cc | NOGROUP. XSPACE—0. NEWPAGE Cc 
“record ID’ BODY. DELIMITER. bytes’ 
X. GROUP. XSPACE—n: LX 
A IN———J 
Lf MM—— 
CM 
POINTSS 
PELS— 
PAGEHEADER: 
t-PAGETRAILER. 
XSPACE—0- 
GRPHEADER. 
XSPACE—n. 
N 
--MM———— 
CM. 
‘OINTS: 
LPELS—— 
--DIRECTION ACROSS. 
>. 
ENDSPACE—n DIRECTION. ACROSS. COLOR—colorname: 
[IN DOWN: RGB—rvalue—gvalue—bvalue: 
tM BACK: HIGHLIGHT—Avalue: 
CI Lyp——_ COVERAGE—cvalue: BLACK—bvalue 
L-POINTS: CMY K—cvalue—mvalue—yvalue—kvalue. 
LPELS. CIELAB—lvalue lvalue: c2value 
LJ Lie 
POSITION - SAME - RELATIVE - NEXT. 
>. 
Lront—nanei— | | YES. es LEFTMARGIN: OPMARGIN. 
> —name2. PRINTDATA: sane or = — LABSOLUTE— 
NO oriz. Re —————_ NENT: 
IN RELATIVE SAME or = 
MM. RELATIVE 
CM. vert: 
POINTS. ABSOLUTE i) IN 
LPELS—— tM 
LC 
t-POINTS- 
LPELS. 
>. 
0—0 
OBJECT. internal name: | Other OBJECT Parameters 
Lrelx—relY— 
0—0 
—VARIABLE—| VARIABLE Parameters f OBTYPE. PSEG. 
Lrelx—relyY— I0CA 
BCOCA: 
GOCA: 
OTHER—OBID. comp-id- 
'_type-name— 
>. 
0. OVROTATE—0. 
OVERLAY. Xname 
—VARTABLE—| VARIABLE Parameters } rel. x-pos—rel. y-pos: OVROTATE- 90 
Le 
270 
> > 
| 
‘SEGMENT: name 
—VARTABLE—| VARIABLE Parameters f rel. x-pos—rel. y-pos. 
VARIABLE Parameters: 
| LENGTH—n | 
START—n— 
FLDNUM—n | | 
START—n LENGTH—n 
RECID | | 
START—n LENGTH—n 
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Other OBJECT Parameters: 


--OBCHPOS—USEOBJ— 


USEOBJ OBMAP. LEFT. | OBCHPOS—x-pos 


OBSIZE 


TRIM—+ 


>. 


--OBCVPOS—US ae --OBROTAT | 


wd | FIT—_ 
unit CENTER 
REPEAT— 


FILL—— 


hg 


unit | 


pos | OBROTATE 90 | OBCOLOR eotorsnane! 


OBCVPOS—y- 


The LAYOUT command is used to format a data record. The LAYOUT command is associated with the 
line of data record using a “record ID” that appears both on the LAYOUT command and in the first 10 
bytes of the data record. The LAYOUT command is used in a different type of page definition, a Record 
Format page definition. The LAYOUT command is analagous to the PRINTLINE and XLAYOUT 
commands in Traditional page definitions and XML page definitions. Of the following commands: LAYOUT, 
PRINTLINE, and XLAYOUT only the LAYOUT command can be used in a Record Format page definition. 


Subcommands 


DEFAULT 


‘record ID' 


BODY 


GROUP 


This keyword is used only when the layout type is either PAGEHEADER or 
PAGETRAILER, and no name is needed. 


The record ID is entered within quotes and must match the record id within the data 
record exactly byte for byte. PPFA does not transle these characters. Hex characters must 
be entered in uppercase within the quotes. The name is padded with blanks if the field 
contains less than 10 characters. 


“C” stands for character input, “A” is ASCII, “E” is EBCDIC, and “X” stands for hex bytes. 
Hexadecimal characters must be entered in uppercase characters. The default is “C”. 


The BODY layout type is used for the majority of data in the user’s database, normally 
printed line by line. This is the default. 


The GROUP parameter indicates that the existing group header should be saved and 
used for subsequent pages. If this parameter is not set when processing starts on a 
BODY layout, the active group header record is discarded and not reprinted on 
subsequent pages. 


PAGEHEADER 


GRPHEADER 


XSPACE 


This layout type specifies a header that is to be printed on each new page. The baseline 
position of this layout is normally in the top margin, but can be anywhere on a logical 
page. If RELATIVE is specified, the position is considered to be relative to the page origin. 
Usually contains customer’s name, address, account number, and so forth. Only one 
default PAGEHEADER layout can be specified in a PAGEFORMAT and no input record 
data can be specified in a default layout. 


This layout type specifies a header that is to be printed at the beginning of a group of 
data. If a logical page eject occurs before the group of data ends, the header is printed 
after the top margin on each new page until the group ends. The baseline position of this 
layout can be specified as RELATIVE. It may include column headings. 


XSPACE indicates the amount of extra space from the position of the layout to the bottom 
of the group header area. This allows the user to identify the amount of eXtra space in 
excess of one text line being used by the header so that the baseline moves down and 
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the following group data is not placed on top of the header area. This space is not 
calculated by PPFA and must be explicitly defined by the user. See example below 
(shaded space shows group header area): 


352 01/04/90 $ 321.50 
353 01/05/90 $ 100.00 
354 01/10/90 $ 122.30 


Figure 115. Example Showing the Use of XSPACE. 


PAGETRAILER 
This layout type specifies a trailer that is to be printed on each new page. The baseline 
position of this layout is normally in the bottom margin, but can be located anywhere on a 
logical page and can be specified as RELATIVE. Only one default PAGETRAILER layout 
can be specified ina PAGEFORMAT and no input record data is processed with a default 
layout. It may contain the name of the form or a footnote. 


NEWPAGE This parameter indicates that a new page should be started with this layout name. If this is 
a header or trailer layout, the print position is moved to the start of a new page before this 
header or trailer becomes the active header or trailer. 


DELIMITER __ The delimiter is a one or two byte code specified in either character or hex indicates a 
delimiting character within the customer's database and is used to separate fields. PPFA 
does not translate these characters. Hex characters must be entered in uppercase within 
the quotation marks. 


ENDSPACE __ If the remaining body space is less than the value specified, ENDSPACE causes a logical 
page eject to be executed. This can be used, for example, on a GRPHEADER layout to 
ensure that a group header does not print at the end of a page without the first data 
record of the group. ENDSPACE does not include the space within the bottom margin 
(specified on the PAGEDEF or PAGEFORMAT command). This indicator is ignored on a 
PAGEHEADER or PAGETRAILER layout. 


DIRECTION _ Specifies the print direction of the line relative to the upper-left corner as you view the 
logical page. Not all printers can print in all print directions. For more information about 
your printer, refer to your printer documentation. 


If DIRECTION is not specified, the direction specified in the |PAGEFORMAT|command is 


used. Observe that this direction is additive to the direction specified in the PAGEFORMAT 
command. See ‘/PAGEFORMAT Command (Record Format and XML)” on page 345 


ACROSS The layout direction is rotated 0 degrees relative to the direction specified 
in the PAGEFORMAT (the layouts are oriented in the same direction as 
the page). 

DOWN The layout direction is rotated 90 degrees relative to the direction specified 
in the PAGEFORMAT. 

BACK The layout direction is rotated 180 degrees relative to the direction 
specified in the PAGEFORMAT. 

UP The layout direction is rotated 270 degrees relative to the direction 
specified in the PAGEFORMAT. 

COLOR Specifies an OCA or defined color for the text of this field. This subcommand is 
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recognized only by printers that support multiple-color printing. Refer to your printer 
publication for information about the colors that can printed. 


colorname Values for colorname are NONE, DEFAULT, BLACK, BLUE, BROWN, 
GREEN, PINK, RED, TURQ (turquoise), YELLOW, ORANGE, PURPLE, 
MUSTARD, GRAY, DARKBLUE, DARKGREEN, or DARKTURQ (dark 
turquoise). The color choices depend on the printer. 


If you do not enter one of these colors, the default color for that printer is 
used. NONE is the color of the medium. DEFAULT is the printer default 
color. 


Note: In some printer manuals, the color turquoise (TURQ) is called 
“cyan”, and the color pink (PINK) is called “magenta”. 


PPFA supports the following synonyms: 
* CYAN for TURQ 

* DARKCYAN for DARKTURQ 

¢ DBLUE for DARKBLUE 

* DCYAN for DARKTURQ 

* DGREEN for DARKGREEN 

* DTURQ for DARKTURQ 

* MAGENTA for PINK 


FONT Defines the font to be used for the layout. 


name? Specifies the name of a font_used to print the data. This font must have 
been defined in a previous|FONT| command in this page definition. 


If Shift-Out, Shift-ln (SOSI) processing is used, name7 must be the 
single-byte font. 
name2 Specify only when using Shift-Out, Shift-In (SOSI) processing to 


dynamically switch between a single-byte font and a double-byte font 
within the layout. name2 must be the double-byte font. 


Notes: 


1. If this subcommand is not specified in the print data, the print server 
uses the font indicated. Otherwise, the print server selects a default 
font. 


2. When selecting a font in AIX, you should consider that the text is 
selected in EBCDIC, not ASCII. Therefore, an EBCDIC font and code 
page 500 (also called International #5) should be used for name7. 


PRINTDATA — Specifies whether the line of data associated with the current LAYOUT should be printed. 
The PRINTDATA subcommand is useful when the data stream is interspersed with lines of 
comments, blank lines, or lines without data that are not meant to be printed. 


YES __ Specifies the data for the current LAYOUT is printed. YES is the default. 
NO Specifies the data for the current LAYOUT is not printed. 


POSITION This is for use in positioning FIELD, DRAWGRAPHIC, & ENDGRAPHIC text and graphics. 
If Relative is specified or POSITION is not specified, the baseline of the Position is relative 
to the previous LAYOUT position. 

1. For PAGEHEADER RCD: The baseline position can be anywhere on a logical page, 
but cannot be specified as Relative. 


2. For PAGETRAILER, GROUPHEADER and BODY RCDs: The baseline position can 
be anywhere on a logical page and can be specified as RELATIVE. 
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Specifies the starting position of the layout in the printout. 


horizontal position 


X-pos 


Specifies the horizontal offset from the left side of the logical page. 
The value is a number with up to three decimal places. The valid 
options for x-pos are described in the SETUNITS command for the 
horizontal value. 


LEFTMARGIN Specifies this line starts at the position specified as the horizontal 


SAME 


RELATIVE 


(x) value in the previous LEFTMARGIN subcommand within this 
page definition. 


Specifies this line starts at the same horizontal offset position as 
the previously coded LAYOUT. If applied to the first LAYOUT of a 
logical page, the horizontal position is 0, which is the default. 


Alternate for SAME. 


Specifies that the following vertical position value is to be processed as a relative 
value. The LAYOUT is positioned relative to the last LAYOUT placed on the page. 


Note: 


If both TOP and RELATIVE are requested for the y-pos value, the 
RELATIVE request is ignored. 


When using RELATIVE positioning, PPFA does not flag off-the-page 
conditions for the position of a LAYOUT or for any overlays, segments or 
objects placed relative to that LAYOUT. LAYOUTs that fall outside the 
bounds of the logical page are flagged by the print server at run time. 


When specifying RELATIVE, use the minus sign to indicate any negative 
values for the LAYOUT vertical position; you may use the plus sign to 
indicate positive values. If no sign is used, a positive value is assumed. 


The DIRECTION for a relative LAYOUT must be ACROSS. Fields 
associated with a relative LAYOUT must have the same DIRECTION as 
the LAYOUT and must match the PAGEFORMAT DIRECTION. 


If RELATIVE is specified with “SAME” or “=” as the “y’ value, the relative 
value in the LAYOUT is +0. 


RELATIVE positioning is allowed on a LAYOUT command only if the 
LAYOUT and all its associated FIELD commands are formatted to print in 
the same direction as the PAGEFORMAT. That is, the DIRECTIONN 
parameter in the LAYOUT and any associated FIELD commands must 
specify (or default to) ACROSS. The DIRECTION in the PAGEFORMAT or 
PAGEDEF command may be any allowable value: ACROSS, DOWN, 
BACK, or UP. 


vertical position 


y-pos 


Specifies the vertical offset from the top side of the logical page. 
The value options for y-pos are described in the SETUNITS 
command for the vertical value. 


TOPMARGIN Specifies that the LAYOUT is placed in the position specified as 


NEXT 


the vertical (y) value in the TOPMARGIN subcommand within this 
page definition. 


Specifies the layout is to be positioned down (on the logical page) 
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one line (as defined in the LINESP subcommand of the last 
SETUNITS command) from the previous field. The LINESP 
subcommand of the SETUNITS command establishes the distance 
from one line to the next. 


When NEXT is specified for the first LAYOUT of a logical page, 
the starting position of the line is one line down from the top of the 
logical page, as defined by the TOPMARGIN subcommand. 


Notes: 

1. The “down” direction is determined by the direction of the 
logical page (as specified in the page format), not the 
LAYOUT direction. NEXT is, therefore, mainly useful in 
ACROSS LAYOUTs. 

2. For additional details on this area, please refer to the URL: 
http://www. ibm.com/printers/R5PSC.NSF/Web/ppfaupdt 


SAME Specifies this LAYOUT starts at the same vertical position as the 
previous LAYOUT. 


= Alternate for SAME. 


OBJECT parameters 


328 


Specifies the name of an object that is to be positioned and oriented relative to the 
location specified in the LAYOUT command in which the OBJECT subcommand was 
named. The OBJECT, as identified by the internal-name parameter, must have been 
defined by an OBJECT command. You may place multiple objects on the same LAYOUT 
command and you may place the same object multiple times. Each placement must have 
its own set of placement parameters, as follows: 


internal-name 
Specifies the name of an object that is up to 16 alphanumeric characters in length. 
The internal-name is used to match the LAYOUT OBJECT subcommand to its 
definition from the OBJECT command. An object must be defined with this internal 
name by the OBJECT command. 


relative-xpos relative-ypos 
Specifies the number of units (inches, mm, and so on) that are added to the 
position of the current LAYOUT to position the top-left corner of the object. The 
values for the horizontal and vertical positioning are limited by the type of printer 
used and the L-units specified with the PELSPERINCH parameter on the 
PAGEDEF or PAGEFORMAT command. 


Each position specification can be a positive or negative number with up to three 
decimal places. The units specified can be one of the following: IN, MM, CM, 
POINTS, or PELS. 


VARIABLE 
Indicates that the actual name of the object is read from the data record. The 
Variable-Name-Locator field specifies where in the data to get the name. 


Note: If you specify VARIABLE for the OBJECT name and don’t want to print the 
name, then you must have at least one field command, or code 
PRINTDATA NO on the LAYOUT command. 


START n The starting position in the data record to get the overlay name. 
The first data byte position of the input record is 1. If START is not 
coded, 1 is assumed. 
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LENGTH n Length of field. Specifies the number (n) of bytes to process from 
the data record, beginning with the position specified in START. 
The maximum length is 8. 


FLDNUM n START n LENGTH n 
The field number. This is the same as in the FIELD command. 
The overlay name is taken from the n field of the input data 
record. START n and LENGTH n describe which portion of the n 
field is used. If omitted, the entire field is used to form the overlay 
name. 


RECID Gets the name from the record id. This is the same as in the 
FIELD command. Use START n and LENGTH n to use only a 
portion of the record id, or leave them out to use the entire record 
field. 


OBSIZE 


Specifies the size of the object placement area. When no OBSIZE is specified, the 
default is the size specified in the object. If no size is specified in the object, the 
size of the page is used. The page width is as specified on the PAGEDEF or 
PAGEFORMAT commands, or it defaults to 8.3 inches by 10.8 inches. 


wd Specifies the width of an object placement area as a number with 
up to three decimal places. The allowable width may vary with the 
type of printer used and the L-units specified with the 
PELSPERINCH parameter on the PAGEDEF or PAGEFORMAT 
command. 


hg Specifies the height of the object placement area as a number 
with up to three decimal places. The allowable height may vary 
with the type of printer used and the L-units specified with the 
PELSPERINCH parameter on the PAGEDEF or PAGEFORMAT 
command. 


unit Specifies a unit of measurement for the width parameter. The 
choices are: IN, MM, CM, POINTS, or PELS. 


Note: If no unit is specified, the default is the most recent 
SETUNITS command value or IN (inch) if a SETUNITS 
command has not been issued. 


USEOBJ Specifies that the size measurements specified in the object are to 
be used. If no size is specified in the object, the size of the page 
is used, which is the length and width as specified on the 
PAGEDEF or PAGEFORMAT commands, or it defaults to 8.3 
inches by 10.8 inches. 


OBMAP 


Specifies mapping options. The OBMAP parameter defines the mapping of the 
object to the object placement area. If OBMAP is not coded, the mapping option 
within the object is used. If the object does not contain a mapping option, then the 
print server sets it to the created default for the container type. 


Each object type (OBTYPE on the OBJECT command) dictates the allowable 
mapping options for that type. When it can, PPFA issues a message when these 
rules are violated. However, in the case of an object type of page segment 


(OBTYPE=PSEG), PPFA does not know what types of objects are contained in it; 
therefore, PPFA cannot enforce the restrictions. See|“OBJECT Command 
(Traditional)” on page 235)for a description of the restrictions. 


LEFT Specifies that the object is positioned at the upper, left-hand 
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TRIM 


FIT 


CENTER 


REPEAT 


FILL 


OBCHPOS 
Specifies the horizontal offset of the object contents within the object placement 
area as a number. 


X-pos 


USEOBJ 


OBCVPOS 
Specifies the vertical offset of the object contents within the object placement 
area, as defined by the OBSIZE parameter. If OBCVPOS is not specified, it 
defaults to USEOBUJ and uses the value set in the object. If no value is set in the 
object, the value defaults to 0. The OBCHPOS parameter is used only in LEFT 
and TRIM mapping of the object into the object placement area. 


PPFA User’s Guide 


y-pos 


corner of the object placement area, as defined or defaulted by 
the relative-xpos, relative-ypos, OBCHPOS, and OBCVPOS 
parameters. Any portion of the object that falls outside the object 
placement area as defined by the OBSIZE parameter is not 
trimmed and could cause an exception condition by the 
presentation system. 


Specifies position and trim. The object is positioned at the upper, 
left-hand corner of the object placement area, as defined or 
defaulted by the relative-xpos, relative-ypos, OBCHPOS, and 
OBCVPOS parameters. Any portion of the object that falls outside 
the object placement area as defined by the OBSIZE parameter is 
trimmed. 


Specifies scale to fit; this is the default value if the OBMAP 
parameter is not coded. The object is to be scaled to fit within the 
object placement area, as defined by the OBSIZE parameter. The 
center of the object is placed in the center of the object placement 
area and the object is scaled up or down to fit the block. Scaling 
in the horizontal and vertical directions is symmetrical. The FIT 
parameter ensures that all of the data in the object is presented in 
the object placement area at the largest possible size. The object 
is not trimmed. 


Specifies that the center of the object be positioned at the center 
of the object placement area. Any portion of the object that falls 
outside the object placement area is trimmed. 


Specifies that the origin of the data object be positioned with the 
origin of the object placement area. The object is then replicated 
in the X and Y directions. If the last replicated data does not fit in 
the object area, it is trimmed to fit. 


Specifies that the center of the data object be positioned 
coincident with the center of the object placement area. The data 
object is then scaled, so that it totally fills the object placement 
area in both the X and Y directions. This may require that the 
object be asymmetrically scaled by different scale factors in the X 
and Y directions. 


Specifies a positive or negative number. The valid options for 
X-pos are described in the SETUNITS command for the horizontal 
value. 


Specifies that the offset value from the object is to be used. If no 
value is set in the object, the value defaults to 0. 


Specifies a positive or negative number. The valid options for 
y-pos are described in the SETUNITS command for the vertical 
value. 


PAGEDEF pd1 Replace Yes 
COMMENT 'this is my program'; 
FONT XF1 ; 


OBJECT xyzIntName 
OBXNAME PSEGxyz 
OBTYPE PSEG ; 


PAGEFORMAT pf1; 
LAYOUT ‘abc' 
OBJECT xyzintname 1.1 in 2.1 in 
OBSIZE 3 in 
OBMAP FILL 
OBCOLOR BLUE ; 
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Specifies that the offset value from the object is to be used. If no 
value is set in the object, the value defaults to 0. 


OBROTATE {019011801270} 
Specifies the object rotation with respect to the current LND’s coordinate system. 


OBCOLOR colorname 
Specifies the color to be used as the default color or initial color for the object 
placement area. The OBCOLOR parameter is used only for objects of the PSEG, 
GOCA, BCOCA, and IOCA type. If the object type is OTHER, this parameter is 
ignored. Colors specified must be of the standard OCA color space. 


Specifies standard OCA color space color names, which are: 


NONE 

DEFAULT 

BLACK 

BLUE 

BROWN 

GREEN 

RED 

PINK (or MAGENTA) 

TURQ (or CYAN) 

YELLOW 

DARKBLUE (or DBLUE) 
ORANGE 

PURPLE 

MUSTARD 

GRAY 

DARKGREEN (or DGREEN) 
DARKTURQ (DTURQ, or DARKCYAN, or DCYAN) 


In the following example, the page definition pd1 has defined an 
object with an external name of “PSEGxyz”, of object type PSEG. 
The object has an internal name of “xyzintname”. The internal 
name identifies the object for the LAYOUT OBJECT subcommand 
when the object is placed. Observe that case is not significant on 
either the internal nor the external names. 


Figure 116. Example of PPFA Support for IOB in a PAGEDEF 


The LAYOUT in PAGEFORMAT pf1 places the object on the page 
1.1 inches to the left and 2.1 inches below the current LAYOUT 
position. It also maps the object into the object area with the FILL 
parameter, which centers the object in the object area and totally 
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fills the area, possibly with different scaling factors in the X and Y 
directions. It has an area size of 3 by 5 inches, and overrides the 
default presentation space color to BLUE. 


OBTYPE Used to specify the type of the object. Observe that each of the 
object types restricts the type of mapping option allowed in the 
placement of the object (OBMAP on the OBJECT subcommand 
on the PRINTLINE command.) 


PSEG Specifies a page segment object, as described in the 
Mixed Object Document Content Architecture (MODCA) 
Reference Manual, SC31-6802. All mapping types 
(OBMAP) are allowed by PPFA, however, the print server 
issues an error if any of the objects contained in the page 
segment are not compatible with the coded OBMAP 
parameter. 


GOCA Specifies a graphic object, as described in the Graphics 
Object Content Architecture (GOCA) Reference Manual, 
SC31-6804. GOCA allows you to specify TRIM, FIT, 
CENTER, REPEAT, and FILL parameters on the OBMAP 
subcommand. 


BCOCA 
Specifies a bar code object, as described in the Bar Code 
Object Content Architecture (BCOCA) Reference Manual, 
$544-3766. BCOCA allows you to specify only the LEFT 
parameter on the OBMAP subcommand. 


IOCA Specifies an image object, as described in the Image 
Object Content Architecture (BCOCA) Reference Manual, 
SC31-6805. IOCA allows you to specify TRIM, FIT, 
CENTER, REPEAT, and FILL parameters on the OBMAP 
subcommand. 


OTHER 
Specifies other object data. The object data to be included 
is a paginated presentation object with a format that may 
or may not be defined by an IBM presentation 
architecture. When you specify OTHER, you must also 
specify the OBID parameter. OTHER allows you to specify 
TRIM, FIT, CENTER, REPEAT, and FILL parameters on 
the OBMAP subcommand. 


OBID Specifies either a component identifier or a type name 
from|Table 18| The OBID is translated into an Encoded 
OID and matched to the OID inside the object; they must 
match. 


component-id Specifies the component identifier. 


type-name The name chosen by PPFA as an 

alternative to coding a component 
identifier. 

Table 18. Non-OCA Objects supported by |OB 

Type-Name Component-id Description of OBID Object Type 

EPS 13 Encapsulated PostScript 

TIFF 14 Tag Image File Format 

332 PPFA User's Guide 


LAYOUT Command (Record Format) 


Table 18. Non-OCA Objects supported by IOB (continued) 


Type-Name Component-id Description of OBID Object Type 

WINDIB 17 Device Dependent Bit Map [DIB], Windows Version 
OS2DIB 18 Device Dependent Bit Map [DIB], PM Version 

PCX 19 Paint Brush Picture File Format 

GIF 22 Graphics Interchange Format 

JFIF 23 JPEG File Interchange Format 

PDFSPO 25 PDF Single Page Object 

PCLPO 34 PCL Page Object 

EPSTR 48 EPS with Transparency 

PDFSPOTR 49 PDF Single Page Object with Transparency 


Table 19. Object Types that can be referenced as Secondary Resources 


Type-Name Component-id Description of OID Type-Name 

PDFRO 26 PDF Resource Object (new) 

RESCLRPRO 46 Resident Color Profile Resource Object 

IOCAFS45RO 47 IOCA FS45 Resource Object Tile (new) 

OVERLAY Specifies the name of an overlay that is to be positioned relative to the location specified 


in the LAYOUT command in which the OVERLAY subcommand was named. The 
PAGEFORMAT OVERLAY command may contain the named overlays. The maximum 
number of overlays specified for a PAGEFORMAT including the LAYOUT OVERLAY 
subcommand is 254. 


Specifies the electronic overlay that is to be used with this subgroup. 
name Specifies the user-access name as defined in the OVERLAY command. 


Notes: 


1. PPFA checks for duplication of local names. If there is a duplication, the page 
definition is generated, but a warning message is issued. 


2. PPFA does not check for duplicate user-access names. 


relative-xpos relative-ypos 
Specifies the number of units (inches, mm, and so on) that are added to the 
position of the layout to position the top-left corner of the overlay. The values for 
horizontal and vertical may be (+) or (—). The maximum value is + or — 32760 
L-units. For example: 
* OVERLAY NAME1 2 in 1 in 
* OVERLAY NAME2 5 mm 1mm 


Note: Any offset coded in the overlay itself is added to this offset. 


VARIABLE 
Indicates that the actual name of the overlay, including the O1 prefix, is read from 
the data record. The Variable-Name-Locator field specifies where in the data to 
get the name. 


Note: If you specify VARIABLE for the OVERLAY name and don’t want to print 
the name, then you must have at least one field command, or code 
PRINTDATA NO on the LAYOUT command. 
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SEGMENT 


START n The starting position in the data record to get the overlay name. 
The first data byte position of the input record is 1. If START is not 
coded, 1 is assumed. 


LENGTH n Length of field. Specifies the number (n) of bytes to process from 
the data record, beginning with the position specified in START. 
The maximum length is 8. 


FLDNUM rn START n LENGTH n 
Field number (Record Layout and XML Page definitions only). This 
is the same as in the FIELD command. The overlay name is taken 
from the “n’th field of the input data record. START n and 
LENGTH n describe which portion of the “n’th field is used. If 
omitted, the entire field is used to form the overlay name. 


RECID Get the name from the record id (Record Layout and XML page 
definitions only). This is the same as in the FIELD command. Use 
START n and LENGTH n to use only a portion of the record id, or 
leave them out to use the entire record field. 


OVROTATE {019011801270} 
Specifies the rotation of the placed overlay with respect to the x-axis of the page. 


See |“FORMDEF Command” on page 185|for an OVROTATE example, which is 


presented in the FORMDEF description. 


Specifies the name of a segment that is to be positioned relative to the location specified 
in the LAYOUT command in which the SEGMENT subcommand was named. The 
PAGEFORMAT SEGMENT command may contain the named segments. The maximum 
number of segments specified for a PAGEFORMAT including the LAYOUT SEGMENT 
subcommand is 127. 


Specifies the page segment that is to be used with this subgroup. 
name Specifies the user-access name as defined in the SEGMENT command. 


Notes: 


1. PPFA checks for duplication of local names. If there is a duplication, the page 
definition is generated, but a warning message is issued. 


2. PPFA does not check for duplicate user-access names. 


relative-xpos relative-ypos 
Specifies the number of units (inches, mm, and so on) that are added to the 
position of the layout to position the top-left corner of the page segment. The 
values for horizontal and vertical may be (+) or (—). The maximum value is + or — 
32760 L-units. For example: 
* SEGMENT MYSEG1 2 in 1 in 
* SEGMENT MYSEG1 5 mm 1 mm 


VARIABLE 
Indicates that the actual name of the segment, including the S1 prefix, is read 
from the data record. The Variable-Name-Locator field specifies where in the 
data to get the name. 


Note: If you specify VARIABLE for the SEGMENT name and don’t want to print 
the name, then you must have at least one field command, or code 
PRINTDATA NO on the LAYOUT command. 


START n The starting position in the data record to get the overlay name. 
The first data byte position of the input record is 1. If START is not 
coded, 1 is assumed. 
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Length of field. Specifies the number (n) of bytes to process from 
the data record, beginning with the position specified in START. 
The maximum length is 8. 


FLDNUM rn START n LENGTH n 


RECID 


Field number (Record Layout and XML Page definitions only). This 
is the same as in the FIELD command. The overlay name is taken 
from the “n’th field of the input data record. START n and 
LENGTH n describe which portion of the “n’th field is used. If 
omitted, the entire field is used to form the overlay name. 


Get the name from the record id (Record Layout and XML page 
definitions only). This is the same as in the FIELD command. Use 
START n and LENGTH n to use only a portion of the record id, or 
leave them out to use the entire record field. 
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OBJECT Command 


OBNOKEEP. 
>>—0BJECT— internal -name—OBXNAME- X=name: OBTYPE- PSEG > 
L y-name IOCA: CMY KSWOP. 


--NOPRELOAD. 
}-BCOCA—————_,__ -CMYKEURO— Losxeer—{ || 
GOCA “_PRELOAD. 


LOTHER - 0BID———component-id- 
Ltype-name——) 


NOPRELOAD- 


-_OB2RESOURCE. OB2XNAME- secondary-x-name: OB2 ID. 
/secondary- internal -namne————————4 L ‘secondary-x-name J 
t-'secondary-internal-name ' 
LTEXTTYPE—'secondary-internal-name '— 


n 
Liype-name— -PRELOAD—— 


The OBJECT command allows you to define an external object to PPFA. Then you can use the LAYOUT 
command with the OBJECT subcommand to place the defined object on a page. 


You can use one LAYOUT command to place one or many defined objects multiple times with different 
placement parameters on each placement. On the LAYOUT OBJECT subcommand, enter information 
about the positioning, rotation, color, object size, and mapping instructions. All positioning is relative to the 
print line coordinate system. The internal-name appears on both the OBJECT command and on the 
LAYOUT OBJECT subcommand, and is used similar to the way overlays and page segments are defined 
and placed (or printed). 


Notes: 


1. The internal-name is case insensitive but, other than that, the internal-name of the OBJECT command 
and of the LAYOUT OBJECT subcommand must match exactly. 


2. This function requires both the print server and printer support. Check your print server and printer 
documentation. 


OBJECT internal-name 
Identifies the object and also is used to match a LAYOUT OBJECT subcommand. The 
internal-name can be no more than 16 alphanumeric characters. 


Subcommands 


OBXNAME x-name 
Specifies the external name of the resource object, which indicates where the object is 
located. For example, in OS/390, the x-name is the member name of the object in the 
object library. No prefixes are assumed on the name. 


The x-name can be no more than 8 alphanumeric characters. If your operating system is 
AIX or Windows, the x-name is translated to EBCDIC. 


Note: Items within quotation marks are not translated to uppercase or to their EBCDIC 
code equivalent. 


OBTYPE Used to specify the type of the object. Observe that each of the object types restricts the 
type of mapping option allowed in the placement of the object (OBMAP on the OBJECT 
subcommand on the LAYOUT command). 


PSEG Specifies a page segment object, as described in the Mixed Object 
Document Content Architecture (MODCA) Reference Manual, 
(SC31-6802). All mapping types (OBMAP) are allowed by PPFA; however, 
the print server issues an error if any of the objects contained in the page 
segment is not compatible with the coded OBMAP parameter. 
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GOCA Specifies a graphics object, as described in the Graphics Object Content 
Architecture (GOCA) Reference Manual, (SC31-6804). GOCA allows you 
to specify TRIM, FIT, CENTER, REPEAT, and FILL parameters on the 
OBMAP subcommand. 


BCOCA 


Specifies a bar code object, as described in the Bar Code Object Content 


Architecture (BCOCA) Reference Manual, (S544-3766). BCOCA allows 
you to specify only the LEFT parameter on the OBMAP subcommand. 


IOCA Specifies a image object, as described in the Image Object Content 
Architecture (IOCA) Reference Manual, (SC31-6805). The IOCA object 
type allows you to specify TRIM, FIT, CENTER, REPEAT, and FILL 
parameters on the OBMAP subcommand. 


OTHER 


Specifies other object data. The object data to be included is a paginated 


presentation object with a format that may or may not be defined by an 
IBM presentation architecture. When you specify OTHER, you must also 
specify the OBID parameter. The OTHER object type allows you to specify 
TRIM, FIT, CENTER, REPEAT, and FILL parameters on the OBMAP 


subcommand. 


The OBID is translated into an Encoded OID and 


OBID Specifies either a component identifier or a type name from 
Table 20 


matched to the OID inside the object; they must match. 


component-id Specifies the component identifier. 


type-name 


Table 20. Non-OCA Objects supported by IOB. 


Type-name is a name chosen by PPFA as an 
alternative to coding a component identifier. 


Type-Name Component-id Description of OBID Object Type 

EPS 13 Encapsulated PostScript 

TIFF 14 Tag Image File Format 

WINDIB 17 Device Dependent Bit Map [DIB], Windows Version 
OS2DIB 18 Device Dependent Bit Map [DIB], PM Version 
PCX 19 Paintbrush Picture File Format 

GIF 22 Graphics Interchange Format 

JFIF 23 JPEG file Interchange Format 

PDFSPO 25 PDF Single Page Object 

PCLPO 34 PCL Page Object 

EPSTR 48 EPS with Transparency 

PDFSPOTR 49 PDF Single Page Object with Transparency 


Table 21. Object Types that can be referenced as Secondary Resources 


Type-Name Component-id Description of OID Type-Name 
PDFRO 26 PDF Resource Object (new) 
RESCLRPRO 46 Resident Color Profile Resource Object 
IOCAFS45RO 47 IOCA FS45 Resource Object Tile (new) 


CMYKSWOP | CMYKEURO 


Indicates the color profile if it is required by the object. 
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OBNOKEEP 


OBKEEP 


This object name is not included in a Map Data Resource structured field making the 
object loadable each time the object is placed on the page. 


This object is included in a Map Data Resource at the beginning of the PAGEDEF making 
a hard object at the beginning of the page and then available throughout without reloading. 
Note that only objects with OBTYPE IOCA and OTHER can be kept. If OBKEEP is coded 
with other than those it is ignored. 


NOPRELOAD | PRELOAD 
If you wish the object to be preloaded prior to the running of this job, specify it 
here. Note that only objects with OBTYPE IOCA and OTHER can be preloaded. If 
PRELOAD is coded with other than those, it is ignored. 


OB2RESOURCE secondary-internal-name 


If the primary contains a reference to one or more secondary objects, you must identify 
them at this point. Specify the internal name for the secondary resource as specified in the 
primary resource. If the internal name contains special characters such as periods or 
blanks, then quotes must surround the name, however, keep in mind that items within 
quotation marks are not translated to uppercase or to their EBCDIC code page 500 
equivalent. For example, if this entry is meant for the MVS environment, make sure that 
the entry is in all uppercase. 


Use the form TEXTTYPE secondary-internal-name when specifying names for mixed 
EBCDIC/ASCII usage. TEXTTYPEs can be a blank, “C”, “X”, “A”, or “E” where a blank or 
“C” means no translation, “X” means hexadecimal, “A” means translate to ASCII, if 
necessary, and “E” means translate to EBCDIC, if necessary. See the TEXT command for 
further description of these types. 


All specified secondary resources are kept. 


OB2XNAME secondary-x-name | 'secondary-x-name' 


This entry contains the external name for the secondary resource. If the external name 
contains special characters such as periods or blanks, then the name can extend to 100 
characters and quotes must surround the name. However, keep in mind that items within 
quotation marks are not translated to uppercase or to their EBCDIC code page 500 
equivalents. For example, if this entry is meant for the MVS environment, make sure that 
the entry is in all uppercase. 


OB2ID n| type-name 


Component type identifier for secondary resource; use an object type number as specified 


in Object type list adjustments. Use an object type number from the “Component-id” 
column or a type name from the “Type-Name” column of|Table 21 on page 337 


NOPRELOAD | PRELOAD 


If you wish the secondary object to be preloaded prior to the running of this job, specify it 
here. 
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OVERLAY Command 
perRELeRES 


>>—OVERLAY—x-name : >< 
| preLoan— 


This OVERLAY command is used to identify an overlay that is positioned on a page at some spot other 
than the position defined within the overlay. This function is similar to the SEGMENT command. A 
separate OVERLAY command is required for each overlay. A maximum of 254 OVERLAY commands 
(each of the 254 names must be unique) can be specified for each page format. 


The OVERLAY commands are nested within the PAGEFORMAT command. 


PAGEFORMAT 
|SEGMENT| ] 
OVERLAY ] 
[ OVERLAY ] 


For the overlay to be used, the end-user must embed an Include Page Overlay (IPO) structured field 
within the line data or unformatted ASCII to be printed. The same name must appear within the structured 
field as identified by this command, and the page origin must be stated. 


OVERLAY name 
Identifies the overlay that is positioned on the page. 


name Specifies the user-access name of an overlay to be used with the page definition. 
The OVERLAY commands can be defined either globally before the first 
PAGEFORMAT command or nested within the PAGEFORMAT definition. 


Note: The prefix 'O1' is not part of the six-character user-access name. The overlay name 
can be alphanumeric. 
Subcommands 


NOPRELOADIPRELOAD 
Indicates whether or not the overlay should be preloaded prior to the processing of the 
job. 
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PAGEDEF Command 
--WIDTH— 8.3 — IN —HEIGHT— 10.8 — IN 
T zi zi 


>>—PAGEDEF—name 


| | 
WIDTH—n HETGHT—n 
uite | Lnpe 
COMMENT—*-qs tring 
--DIRECTION—ACROSS REPLACE NO— 
>. > 
‘DIRECTION DOWN REPLACE YES— | pELSPERINCH—n_| ‘_TOPMARGIN—n 
aac kK IN——_+ 
UP—— MM: 
¢M———_ 
POINTS 
PELS—— 
>. > 
'_BOTMARGIN—n | | LEFTMARGIN—n | | RIGHTMARGIN—n 
IN IN IN 
MM: MM: MM 
CM. CM. CM 
POINTS POINTS POINTS 
--PELS-— --PELS L_PELS-—— 
>. > 
'_PAGECOUNT | 
CONTINUE CMP. | CCP | 
Ll 
STOP. 
RESUME: 
re 
RESET 
re 
(1) 
--UDType platform dependent (EBCDIC or ASCII) 
be 
UDType EBCDIC 
ASCII 
UNICODE 
UCS2 
UTF8 
__UTF16— 
Notes: 


1 UDType is valid only as an XML page definition. 
A page definition is a resource used to define how data is to be formatted on a logical page. When 


generated by PPFA, a page definition is stored as a resource in the page-definition library. This 
command’s subcommands allow you to use with the record format line data. 
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This command’s subcommands must be specified when you define a page definition when using record 
formatting. All of the PAGEDEF subcommands are optional; and have default values. 


PAGEDEF 


Identifies the page definition to be used with the print job. 


name 


Subcommands 


COMMENT astring 
Specifies a user comment. This string comment is placed in the NOP structured field of 
the page definition. 


WIDTH 


HEIGHT 


DIRECTION 


qstring 


Defines an alphanumeric name of 1 to 6 characters for the page definition. When 
page definitions are generated, PPFA assigns the prefix ‘P1’ to this name as the 
external resource name. 


Specifies a quoted set of strings from 1 to 255 characters in total length. 


Defines the width of the logical page. 


n 


unit 


A number with up to three decimal places. The width may vary according to the 
type of printer being used. For more information, refer to your printer 
documentation. The default is 8.3 IN. 


Specifies a unit of measurement for the WIDTH subcommand. The choices are IN, 
MM, CM, POINTS, or PELS. 


Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 


Defines the height of the logical page. 


n 


unit 


A number with up to three decimal places. The height may vary according to the 
type of printer being used. For more information, refer to your printer 
documentation. The default is 10.8 IN. 


Specifies a unit of measurement for the HEIGHT subcommand. The choices are 
IN, MM, CM, POINTS, and PELS. 


Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 


Specifies the print direction of the logical page. Not all printers can print in all print 
directions. For more information, refer to your printer documentation. 


Note: 


Some printers have a different media origin and require different direction settings 
than most page printers. For printing in the landscape page presentation when 
using wide forms, the PRESENT subcommand must be specified on the [FORMDEF| 
command to produce readable output. Alternatively, if you have existing page 
definitions, the UP direction can be used in the page definition without changes to 
the form definition to produce the same result. 


ACROSS The page is printed with the characters added /eft to right in each line, and 


DOWN 


BACK 


UP 


the lines added from the top to the bottom. 


The page is printed with the characters added to the page from top to 
bottom, and the lines added from the right to the left. 


The page is printed with the characters added to the page from right to 
left, and the lines added from the bottom to the top. 


The page is printed with the characters added to the page from bottom to 
top, and the lines added from the left to the right. 
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DIRECTION effects the meaning of the following new margin parameters: 


Notes: 


1. If the DIRECTION is ACROSS, the TOPMARGIN refers to the margin in the short end 
of the physical page where the tops of the characters point toward that same short 
end. 


2. If the DIRECTION is DOWN, then TOPMARGIN refers to the margin in the long end of 
the physical page where the tops of the characters point toward that same long end. 


REPLACE Specifies whether this page definition is to replace an existing one with the same resource 
name in the library. 


NO This page definition does not replace one with the same resource name in the 
library. 


If a page definition with the same resource name does not exist in the library, this 
page definition is stored. 


YES _ If a page definition with the same resource name already exists in the library, this 
page definition replaces it. 


If a page definition with the same resource name does not exist in the library, this 
page definition is stored. 


PELSPERINCH n 
Specifies the Logical Units in pels per inch for this page definition. Use the 
PELSPERINCH parameter to tell PPFA the pel resolution of your printer in order to 
generate more exact object placements. 


n Specifies an integer number between 1 and 3,276, which determines the Logical Units 
in pels per inch. 


Note: If the L-Units are not specified on this page definition, they default to 240 pels per 
inch. 


PAGEDEF xmp01 replace yes 
PELSPERINCH 300; 
FONT abc; 


PAGEFORMAT P1 
width 7 in 
height 3 in; 

LAYOUT '‘abc'; 


PAGEFORMAT P2 
width 7 in 
height 3 in 
PELSPERINCH 1200; 

LAYOUT 'def'; 


Figure 117. PELSPERINCH example 


In|Figure 102 on page 241| the page definition xmp01 has specified L-Units as 300 


pels per inch. Because the PAGEFORMAT P1 does not specify L-Units, it inherits 
300 pels per inch. PAGEFORMAT P2 specifies L-Units as 1200 pels per inch. 


The width and height in PAGEFORMAT P14 ( 7 in, 3 in) produces internal and 
structured field values of 2100 and 900, whereas in PAGEFORMAT P2 the same 
code produces values of 8400 and 3600, because of the difference in L-Units. 


TOPMARGIN This keyword with parameters specifies the amount of space to be reserved at the top of 
the page. 
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The default is 80% of the current line spacing. 


BOTMARGIN This keyword with parameters specifies the amount of space to be reserved at the bottom 
of the page. Only PAGETRAILER data can be written into this area. If a graphic has not 
been ended at the time information is being placed in the bottom margin, the graphic is 
ended prior to the bottom margin. The default is 0. 


LEFTMARGIN This keyword with parameters specifies the amount of space to be reserved at the left of 
the page. This is to be used only in conjunction with the[DRAWGRAPHIC| commands. 
Although PPFA collects the left margin information, it uses the value only within PPFA to 
define an area. The value itself is not passed in the datastream. The default is 0. 


RIGHTMARGIN 
This keyword with parameters specifies the amount of space to be reserved at the right of 
the page. This is only to be used in conjunction with the[DRAWGRAPHIC| commands. 
Although PPFA collects the right margin information, it uses the value only within PPFA to 
define an area. The value itself is not passed in the datastream. The default is 0. 


PAGECOUNT This keyword allows the user to specify how the page counting is to be handled when 
switching between PAGEFORMATs. 


CONTINUE Page counting continues from the previous PAGEFORMAT - this is the 
default. The n value is only used on the first PAGEFORMAT in the job, 
otherwise it is ignored. If this is the first PAGEFORMAT and no n value is 
specified, it defaults to one. 


STOP Page counting stops. Page count is captured from the previous 
PAGEFORMAT, but does not continue to count. 
RESUME Page counting continues from wherever it was the last time this 


PAGEFORMAT was called. The rn value sets the value only the first time 
the PAGEFORMAT is invoked. 


RESET Page counting is reset to the value within then value. If no n value is 
entered, then the page numbers are reset to one. 


CMP Count MO:DCA Pages option. Tells the print server to count any imbedded 
MO:DCA pages in the page count. 


CCP Count Constant Pages options. Tells the print server to count any pages 
that have no variable data on them. 


UDType 


Note: UDType is valid only as an XML page definition. 

This command identifies the coding of your data. If it does not match the platform data 
type, it causes all qualified tags, attribute names, and FIELD and CONDITION text to be 
translated by PPFA to that data type. For example, on an OS/390 platform the PPFA page 
definition code is assumed to be EBCDIC code page 500. If you specify that your data 
type (UDType) is UTF8, PPFA translates all FIELD and CONDITION text, start tags, and 
attribute names from EBCDIC code page 500 to UTF8. 


The UDType is also passed on to the printer (or other presentation device) so that it can 
translate the data to the font code if that transformation is supported. Allowed 
combinations are explained in |‘FONT Command (XML)” on page 320 

lf UDType is not coded on the PAGEDEF, it defaults to either EBCDIC or ASCII according 
to the platform and no translation is performed. 

EBCDIC Single-byte EBCDIC code page 500. 

ASCII Single-byte ASCII code page 819 
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Fixed two-byte UNICODE without surrogates. This is also known as 
USC2. 


Unicode encoding from UTF-8 toleration mode (surrogates are allowed). 


Unicode encoding from UTF-16. 


Note: The PAGEDEF is created in UTF-16BE (Big Endian). If the data is 
in UTF16LE, PSF translates it to UTF-16BE before processing. 


PAGEFORMAT Command (Record Format and XML) 
PAGEFORMAT Command (Record Format and XML) 


PAGEFORMAT Command 
DIRECT ION—ACROSS 
| 


>>—PAGEFORMAT—name 


WIDTH—n 7] | HEIGHT—n 7] | DIRECTION DOWN 
“unit —unit BACK 
Lyp—_I 
>. > 
| peLspeRINCH—n— '—TOPMARGIN—n | BOTMARGIN—n | 
IN IN 
MM MM 
CM CM 
POINTS POINTS 
'—PELS—— '—PELS—— 
i‘ 
Le TMARGIN n RIGHTMARGIN—n 
IN IN 
MM MM 
CM CM 
POINTS POINTS 
'—PELS— '—PELS—— 
> | 3 >< 
—PAGECOUNT 
poe ed Low] Lec! 
n 
STOP 
RESUME 
ra 
RESET 
ad 


Page formats are subsets of page definitions. If you want to use more than one set of specifications to 
format a page within a single print job, you must use more than one page format. To change page formats, 
use conditional processing or insert an Invoke Data Map structured field in your print file. (Page formats 
are known to the print server as data maps.) If you do not use conditional processing or if you do not 
insert an Invoke Data Map structured field, the print server uses only the first page format in the page 
definition. Page formats are placed in the page definition in the order in which they are generated. 


PAGEFORMAT subcommands have no fixed defaults. The entire PAGEFORMAT command and all of its 
subcommands can assume defaults. If any PAGEFORMAT subcommand is omitted, its value is selected 
from the corresponding subcommand in the governing IPAGEDEF| command. 


This command can be omitted for the first page format in a page definition if only one page format is used. 
If omitted, PPFA assigns a page format name by using the page-definition name, including the ‘P1’ prefix. 
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PAGEFORMAT name 
Specifies an alphanumeric name of 1 to 8 characters. This name must be unique within the page 
definition. 


The following subcommands are used for each page format. They may be issued in the same way 
as in a page definition. Values specified in the PAGEDEF subcommands are used if any of the 
following subcommands are not defined within a page format. 


Subcommands 
WIDTH Defines the width of the logical page. 
n A number with up to three decimal places is used. The width may vary according 
to the type of printer being used. For more information, refer to your printer 
documentation. 


unit Specifies a unit of measurement for the WIDTH subcommand. The choices are IN, 
MM, CM, POINTS, or PELS. 


Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 


HEIGHT Defines the height of the logical page. 
n A number with up to three decimal places. The height may vary according to the 
type of printer being used. For more information, refer to your printer 
documentation. 


unit Specifies a unit of measurement for the HEIGHT parameter. The choices are IN, 
MM, CM, POINTS, or PELS. 


Note: If no unit is specified, the default is the most recent SETUNITS command 
value or IN (inch) if a SETUNITS command has not been issued. 


DIRECTION _ Specifies the print direction of the logical page. Not all printers can print in all print 
directions. For more information, refer to your printer documentation. 


Note: Some printers have a different form origin and require different direction settings 
than most page printers. For printing in the landscape page presentation when 
using wide forms, the PRESENT subcommand must be specified on the [FORMDEF| 
command to produce readable output. Alternatively, if you have existing page 
definitions, the UP direction can be used in the page definition without changes to 
the form definition to produce the same result. 


ACROSS The page is printed with the characters added to the page from /eft to 
right, and the lines added from the top to the bottom. 


DOWN The page is printed with the characters added to the page from top to 
bottom, and the lines added from the right to the left. 


BACK The page is printed with the characters added to the page from right to 
left, and the lines added from the bottom to the top. 


UP The page is printed with the characters added to the page from bottom to 
top, and the lines added from the left to the right. 


DIRECTION effects the meaning of the following new margin parameters. 
¢ If the DIRECTION is ACROSS, then TOPMARGIN refers to the margin in the short end 
of the physical page where the tops of the characters point toward that same short end. 


¢ If the DIRECTION is DOWN, then TOPMARGIN refers to the margin in the long end of 
the physical page where the tops of the characters point toward that same long end. 
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PELSPERINCH n 
Specifies the Logical Units in pels per inch for this page format. Use the PELSPERINCH 
parameter to tell PPFA the pel resolution of your printer in order to generate more exact 
object placements. 


n_ Specifies an integer number between 1 and 3,276, which determines the Logical Units 
in pels per inch. 


Note: If the L-Units are not specified on the page format, they are inherited from the page 
definition that contains this page format. See|Figure 102 on page 241 
TOPMARGIN This keyword with parameters specifies the amount of space to be reserved at the top of 
the page. The default is 80% of the current line spacing. 


BOTMARGIN This keyword with parameters specifies the amount of space to be reserved at the bottom 
of the page. The default is 0. 


LEFTMARGIN This keyword with parameters specifies the amount of space to be reserved at the left of 
the page. This is only used in conjunction with the DRAWGRAPHIC commands. Although 
PPFA collects the left margin information, the value is used only within PPFA to define an 
area. The value itself is not passed in the datastream. The default is 0. 


RIGHTMARGIN 
This keyword with parameters specifies the amount of space to be reserved at the right of 
the page. This is only to be used in conjunction with the DRAWGRAPHIC commands. 
Although PPFA collects the right margin information, it uses the value only within PPFA to 
define an area. This value itself is not passed in the datastream. The default is 0. 


PAGECOUNT This keyword allows the user to specify how the page counting is to be handled when 
switching between page formats. 


CONTINUE Page counting continues from the previous page format - this is the 
default. The n value is only used on the first PAGEFORMAT in the job, 
otherwise it is ignored. If this is the first PAGEFORMAT and no n value is 
specified, it defaults to one. 


STOP Page counting stops. Page count is captured from the previous page 
format, but does not continue to count. 


RESUME Page counting continues from wherever it was the last time this page 
format was called. The n value sets the value only the first time page 
format is invoked. 


RESET Page counting is reset to the value within the n value. If no n value is 
entered, then the page numbers are reset to one. 


CMP Count MO:DCA Pages option. Tells the print server to count any imbedded 
MO:DCA pages in the page count. 


CCP Count Constant Pages options. Tells the print server to count any pages 
that have no variable data on them. 
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SEGMENT Command 
>>—SEGMENT—name—3; 


<4 


Use the SEGMENT command only if you want page segments to be loaded to the printer before the page 
begins printing. If segments are used repeatedly and need to be available in the printer, this eliminates the 
need to load them each time. However, they do take up raster-pattern storage. If the segments are 
included on a page but not in the SEGMENT command, they are loaded to the printer as they are used in 
the print data. 


A separate SEGMENT command is required for each page segment with a maximum of 127 SEGMENT 
commands within a single page format. 


SEGMENT 
SEGMENT 
A SEGMENT command is nested within the page format and follows the PAGEFORMAT command. 


SEGMENT name 
Specifies the alphanumeric name of 1 to 6 characters (user-access name) of the page segment. 
Each name must be unique within a single page format. 


Note: The prefix 'S1' is not part of the six-character user-access name. 
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SETUNITS Command 


>>—SETUNITS 


C 1 —IN— 1 Se 
: >< 
Xx y | LINESP—n IN | 
IN IN MM 
MM MM CM 
CM CM POINTS 
POINTS POINTS PELS 
PELS PELS ‘—_LPI—— 
—CPI—— ‘—LPI—— 


The SETUNITS command specifies the value and the unit of measurement that are the defaults for any 
subsequent measurement parameter in all of the commands and subcommands. These values remain the 
default values until another SETUNITS command is specified. The SETUNITS command should be 
specified as the first command in a page definition. If neither this command nor a measurement parameter 
is specified, the defaults identified within the following description are used. 


SETUNITS 


Specifies the value and the unit of measurement that are the defaults for any subsequent 
measurement parameter in all of the commands and subcommands. 


X-pos Specifies the number used for horizontal measurement. A number with up to three 
decimal places is used. The default is 1. The choices are IN, MM, CM, POINTS, 
PELS, or LPI. The default is IN. 


Note: This value affects subsequent OFFSET subcommands. 


y-pos Specifies the number used for vertical measurement. A number with up to three 
decimal places is used. The default is 1. The choices are IN, MM, CM, POINTS, 
PELS, or LPI. The default is IN. 


Note: This value affects subsequent OFFSET subcommands. 
Using CPI and LPI Units of Measurement 


The CPI and LPI units of measurement make it possible to write the following command: 
SETUNITS 10 CPI 6 LPI ; 


This command sets the units of measurement for horizontal and vertical spacing in terms 
of characters per inch and lines per inch. You can then use the OFFSET subcommand 
specifications to increment the spacing one character or one line at a time. The distance 
specified by n characters over and by n lines down is defined in the governing SETUNITS 
command. In this example, there are 10 characters per inch (CPI) and 6 lines per inch 
(LPI). 


Subcommand 


LINESP 


Determines the line density or “leading” of the text. Any unit of measurement can be used. 
This subcommand value affects the LAYOUT NEXT subcommand. 


n The meaning is determined by the type of unit-of-measurement specified in the 
unit parameter. 


LPI The number of lines per inch 
All others The distance between lines 


unit Specifies a unit of measurement. The choices are: 
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CM 
PELS 


POINTS 


Inch 
Lines-per-inch 
Millimeter 
Centimeter 


L-units per inch (The number of L-units per inch can be defined by 
the user or can default to 240 L-units in an inch) 


Points per inch (72 points in an inch) 
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XLAYOUT Command 


XLAYOUT Command (XML) 


DEFAULT. BODY—NOGROUP—XSPACE—0 
>>—X LAYOUT: qtagname 
NOGROUP. XSPACE—0. L_NEWPAGE_ 
BODY: 
LQTAG—*-starting— GROUP. XSPACE—n: 
L-IN 
LMM 
LCM. 
L-POINTS: 
LPELS 
L-PAGEHEADER 
L continue! 
L-PAGETRAILER 
L continue 
oe J 
L_GRPHEADER: 
CONTINUE XSPACE—n 
IN 
MM: 
CM 
POINTS 
LPELS—— 
DIRECTION ACROSS 
>. 
C | ENDSPACE—n DIRECTION ACROSS 
DELIMITER bytes’ IN DOWN 
LX MM BACK: 
CM. L_yp——_ 
POINTS 
L-PELS—— 
>. 
L-COLOR—colorname | FONT—name1 
RGB—rvalue—gvalue—bvalue Ly, aed 
L-HIGHLIGHT—hvalue 
COVERAGE—cvalue BLACK—bvalue 
CMYK—cvalue—mvalue—yvalue—kvalue 
CIELAB—lvalue clvalue c2value 
Lee! L (J 
>- 
YES. 
L_PRINTDATA 
L_yo— 
POS ITION—ABSOLUTE—SAME—RELAT I VE—NEXT: 
>. 
--ABSOLUTE— 
LEFTMARGIN 
L-SAME or 
horiz n 
RELATIVE 
POSITION -| TOPMARGIN. 
RELATIVE LEFTMARGIN ‘ABSOLUTE: NEXT. 
(+) L-SAME or = 
horiz n IN (+) 
L(-)H MM. vert. IN 
CM L(-)~ MM. 
POINTS CM. 
L-PELS—— POINTS 
LPELS—— 
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>. > 
0—0: 

_OBJECT—internal name | Other OBJECT Parameters 
_relX—rely— 


>. 


| 0—0. OVROTATE—0: 
OVERLAY—Xname 
rel. x-pos—rel. y-pos OVROTATE 90: 
180 
L270 
>. H >< 
0—0. | 
SEGMENT—Xname 


Lrel. x-pos—rel. y-pos— 


Other OBJECT Parameters: 


OBCHPOS—USEOBJ 


USEOBJ OBMAP LEFT. OBCHPOS—x-pos 
OBSIZE TRIM——+ 
wd: hg FIT——J 
unit | unit | CENTER 
REPEAT] 
FILL—— 
OBCVPOS—USEOBJ OBROTATE—O: 
’ | 
OBCVPOS—y-pos OBROTATE 90 OBCOLOR: sista! 
180: 
270 


The XLAYOUT command addresses an XML data item by specifying a QTAG (qualified tag) for that data. 
A QTAG is a series of XML start tags that fully identify the XML data item. 


Before printing the data, PSF scans the XML data item and matches it to an XLAYOUT command in the 
page definition by using its QTAG. The matching XLAYOUT command in the page definition is used to 
position and format the associated XML data item and its attributes on the printed page. 


The XML page definition function has the following new PPFA concepts: 


Relative Inline Positioning: 
Relative inline positioning places data relative to the current position. If you position a text field 
and then place the text, the end of the text becomes the new current position. Graphics, barcodes, 
objects, segments, and overlays do not change the current position after they are originally 
positioned. For example, if you position a line with a DRAWGRAPHIC LINE command, the new 
current position is the starting point of that line. The length of the graphic line does not change the 
current position. 


There are several restrictions when using relative inline positioning: 


1. XLAYOUT commands with relative positioning cannot contain any of the following: 
¢ FIELD commands with inline positioning relative to the XLAYOUT (LPOS) 
¢ FIELD ATTR (attribute) with inline positioning relative to the XLAYOUT (LPOS) 
¢ FIELD commands with barcodes 
* DRAWGRAPHIC commands 
* OBJECT subcommands 
* SEGMENT subcommands 
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* OVERLAY subcommands 


2. You can only use the SAME parameter for inline positioning on the XLAYOUT command when 
the previously used XLAYOUT command used absolute inline positioning. 


Absolute Inline Positioning: 
Allows absolute inline positioning on a FIELD command for specific placement of elements. 


Attributes are Special FIELDs: 
The attribute is identified by name and the data printed is from the attribute value or a portion of 
the attribute value and not from the element content. 


Notes: 


1. Ifa FIELD is used for presenting any piece of data on the XLAYOUT command, FIELD commands 
must be used for all pieces of data presented on the XLAYOUT command. Since an attribute is a 
special field, if you want to print both an attribute value and the element data you need to code the 
attribute field for the attribute value and a regular field for the element data. 


2. PSF suppresses leading and trailing blanks (X'40' for EBCDIC or X'20' for ASCII) in the data. Multiple 
embedded blanks are reduced to one blank. 


3. The XLAYOUT command is used in a different type of page definition, an XML page definition. The 
XLAYOUT command is analagous to the PRINTLINE and LAYOUT commands in traditional page 
definitions and Record Format page definitions. Of the three commands (LAYOUT, PRINTLINE, and 
XLAYOUT), only the XLAYOUT command can be used in an XML page definition. 


Subcommands 


DEFAULT This keyword is used only when the layout type is either PAGEHEADER or 
PAGETRAILER, and no name is needed. Only one default PAGEHEADER or 
PAGETRAILER can be specified in a PAGEFORMAT. 


qtagname The qtagname is a defined Qualified Tag. It is defined by the DEFINE qtagname QTAG 
command at the beginning of the page definition. 


QTAG siarttag This is an explicit Qualified Tag. It is defined by coding a series of start tags separated by 
commas. A start tag is an XML data element name. Put the start tag in quotes if you want 
to preserve it’s case. Otherwise it is folded to upper case. 


<person> 
<name> 
<first>Justin</first> 
<last>Case</last> 
</name> 
</person> 


PAGEDEF xxx...; 
DEFINE Zname QTAG 'person','name', ‘last'; 


Pageformat x ... 
XLAYOUT Zname POSITION... 


Pageformat y ... 
XLAYOUT QTAG 'person','name','last' POSITION ... 


Figure 118. Example of XML data with the associated page definition 


In|Figure 118} “person”, “name”, and “first” are start tags. The qualifying tag for the data 
item “Case” is “person','name’,‘last’”. In the example page definition both of the x and y 


XLAYOUT commands address the same XML data item “Case”. 
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BODY The BODY layout type is used for the majority of data in your database. This is the 
default. 
GROUP The GROUP parameter indicates that the existing group header should be saved and 


used for subsequent pages. If this parameter is not set when processing starts on a 
BODY layout, the active group header record is discarded and not reprinted on 
subsequent pages. 


PAGEHEADER 
This layout type specifies a header that is to be printed on each new page. The baseline 
position of this layout is normally in the top margin, but can be anywhere on a logical 
page. If RELATIVE is specified, the position is considered to be relative to the page origin. 
Usually contains customer’s name, address, account number, and so forth. Only one 
default PAGEHEADER layout can be specified in a PAGEFORMAT and no input record 
data can be specified in a default layout. 


CONTINUE The CONTINUE parameter indicates that this XLAYOUT command is a 
continuation of the Page Header definition. The formation of the Page 
Header may require the data from more than one data element. This is 
done by specifying the CONTINUE parameter. 


GRPHEADER This layout type specifies a header that is to be printed at the beginning of a group of 
data. If a logical page eject occurs before the group of data ends, the header is printed 
after the top margin on each new page until the group ends. The baseline position of this 
layout can be specified as RELATIVE. It may include column headings. 


CONTINUE The CONTINUE parameter indicates that this XLAYOUT command is a 
continuation of the Group Header definition. The formation of the Group 
Header may require the data from more than one data element. This is 
done by specifying the CONTINUE parameter. 


XSPACE XSPACE indicates the amount of extra space from the position of the layout to the bottom 
of the group header area. This allows the user to identify the amount of eXtra space in 
excess of one text line being used by the header so that the baseline moves down and 
the following group data is not placed on top of the header area. This space is not 
calculated by PPFA and must be explicitly defined by the user. See example below 
(shaded space shows group header area): 


352 01/04/90 $ 321.50 
353 01/05/90 $ 100.00 
354 01/10/90 $ 122.30 


Figure 119. Example Showing the Use of XSPACE. 


PAGETRAILER 
This layout type specifies a trailer that is to be printed on each new page. The baseline 
position of this layout is normally in the bottom margin, but can be located anywhere on a 
logical page and can be specified as RELATIVE. Only one default PAGETRAILER layout 
can be specified in a PAGEFORMAT and no input record data is processed with a default 
layout. It may contain the name of the form or a footnote. 


CONTINUE The CONTINUE parameter indicates that this XLAYOUT command is a 
continuation of the Page Trailer definition. The formation of the Page 
Trailer may require the data from more than one data element. This is 
done by specifying the CONTINUE parameter. 
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DELIMITER 


ENDSPACE 


DIRECTION 


COLOR 
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This parameter indicates that a new page should be started with this layout name. If this is 
a header or trailer layout, the print position is moved to the start of a new page before this 
header or trailer becomes the active header or trailer. 


The delimiter is a one or two byte code specified in either character or hex indicates a 
delimiting character within the customer's database and is used to separate fields. PPFA 
does not translate these characters. Hex characters must be entered in uppercase within 
the quotation marks. 


If the remaining body space is less than the value specified, ENDSPACE causes a logical 
page eject to be executed. This can be used, for example, on a GRPHEADER layout to 
ensure that a group header does not print at the end of a page without the first data 
record of the group. ENDSPACE does not include the space within the bottom margin 
(specified on the PAGEDEF or PAGEFORMAT command). This indicator is ignored on a 
PAGEHEADER or PAGETRAILER layout. 


Specifies the print direction of the line relative to the upper-left corner as you view the 
logical page. Not all printers can print in all print directions. For more information about 
your printer, refer to your printer documentation. 


If DIRECTION is not specified, the direction specified in the |PAGEFORMAT|command is 


used. Observe that this direction is additive to the direction specified in the PAGEFORMAT 
command. See ‘(PAGEFORMAT Command (Record Format and XML)” on page 345 


ACROSS The layout direction is rotated O degrees relative to the direction specified 
in the PAGEFORMAT (the layouts are oriented in the same direction as 
the page). 

DOWN The layout direction is rotated 90 degrees relative to the direction specified 
in the PAGEFORMAT. 

BACK The layout direction is rotated 180 degrees relative to the direction 
specified in the PAGEFORMAT. 

UP The layout direction is rotated 270 degrees relative to the direction 


specified in the PAGEFORMAT. 


Specifies an OCA or defined color for the text of this field. This subcommand is 
recognized only by printers that support multiple-color printing. Refer to your printer 
publication for information about the colors that can printed. 


colorname Values for colorname are NONE, DEFAULT, BLACK, BLUE, BROWN, 
GREEN, PINK, RED, TURQ (turquoise), YELLOW, ORANGE, PURPLE, 
MUSTARD, GRAY, DARKBLUE, DARKGREEN, or DARKTURQ (dark 
turquoise). The color choices depend on the printer. 


If you do not enter one of these colors, the default color for that printer is 
used. NONE is the color of the medium. DEFAULT is the printer default 
color. 


Note: In some printer manuals, the color turquoise (TURQ) is called 
“cyan”, and the color pink (PINK) is called “magenta”. 


PPFA supports the following synonyms: 
* CYAN for TURQ 

* DARKCYAN for DARKTURQ 

* DBLUE for DARKBLUE 

* DCYAN for DARKTURQ 

* DGREEN for DARKGREEN 

* DTURQ for DARKTURQ 
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FONT 


PRINTDATA 


POSITION 


¢ MAGENTA for PINK 
Defines the font to be used for the layout. 


name? Specifies the name of a font used to print the data. This font must have 
been defined in a previous|FONT| command in this page definition. 


If Shift-Out, Shift-ln (SOSI) processing is used, name7 must be the 
single-byte font. 


name2 Specify only when using Shift-Out, Shift-In (SOSI) processing to 
dynamically switch between a single-byte font and a double-byte font 
within the layout. name2 must be the double-byte font. 


Notes: 


1. If this subcommand is not specified in the print data, the print server 
uses the font indicated. Otherwise, the print server selects a default 
font. 


2. When selecting a font in AIX, you should consider that the text is 
selected in EBCDIC, not ASCII. Therefore, an EBCDIC font and code 
page 500 (also called International #5) should be used for name7. 


Specifies whether the line of data associated with the current LAYOUT should be printed. 
The PRINTDATA subcommand is useful when the data stream is interspersed with lines of 
comments, blank lines, or lines without data that are not meant to be printed. 


YES _ Specifies the data for the current XLAYOUT is printed. YES is the default. 
NO Specifies the data for the current XLAYOUT is not printed. 


This is for use in positioning FIELD, DRAWGRAPHIC, & ENDGRAPHIC text and graphics. 

If Relative is specified or POSITION is not specified, the baseline of the Position is relative 

to the previous LAYOUT position. 

1. For PAGEHEADER RCD: The baseline position can be anywhere on a logical page, 
but cannot be specified as Relative. 


2. For PAGETRAILER, GROUPHEADER, and BODY RCDs: The baseline position can 
be anywhere on a logical page and can be specified as RELATIVE. 


Specifies the starting position of the layout in the printout. 


RELATIVE 
Specifies that the following horizontal position value is to be processed as a value 
relative to the current inline position. 


horizontal position 


X-pos Specifies the horizontal offset from the left side of the logical page. 
The value is a number with up to three decimal places. The valid 
options for x-pos are described in the SETUNITS command for the 
horizontal value. 


LEFTMARGIN Specifies this line starts at the position specified as the horizontal 
(x) value in the previous LEFTMARGIN subcommand within this 
page definition. 


SAME Specifies this line starts at the same horizontal offset position as 
the previously coded XLAYOUT. If applied to the first XLAYOUT 
of a logical page, the horizontal position is 0, which is the default. 
Note: This parameter is not valid with RELATIVE horizontal. 


= Alternate for SAME. 
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Specifies that the following vertical position value is to be processed as a relative 
value. The XLAYOUT is positioned relative to the last XLAYOUT placed on the 


page. 


Note: 


If both TOP and RELATIVE are requested for the y-pos value, the 
RELATIVE request is ignored. 


When using RELATIVE positioning, PPFA does not flag off-the-page 
conditions for the position of a XLAYOUT or for any overlays, segments or 
objects placed relative to that XLAYOUT. XLAYOUTs that fall outside the 
bounds of the logical page are flagged by the print server at run time. 


When specifying RELATIVE, use the minus sign to indicate any negative 
values for the XLAYOUT vertical position; you may use the plus sign to 
indicate positive values. If no sign is used, a positive value is assumed. 


The DIRECTION for a relative XLAYOUT must be ACROSS. Fields 
associated with a relative XLAYOUT must have the same DIRECTION as 
the XLAYOUT and must match the PAGEFORMAT DIRECTION. 


If RELATIVE is specified with “SAME” or “=” as the “y’ value, the relative 
value in the XLAYOUT is +0. 


RELATIVE positioning is allowed on a XLAYOUT command only if the 
XLAYOUT and all its associated FIELD commands are formatted to print in 
the same direction as the PAGEFORMAT. That is, the DIRECTIONN 
parameter in the XLAYOUT and any associated FIELD commands must 
specify (or default to) ACROSS. The DIRECTION in the PAGEFORMAT or 
PAGEDEF command may be any allowable value: ACROSS, DOWN, 
BACK, or UP. 


vertical position 


y-pos 


Specifies the vertical offset from the top side of the logical page. 
The value options for y-pos are described in the SETUNITS 
command for the vertical value. 


TOPMARGIN Specifies that the XLAYOUT is placed in the position specified as 


NEXT 


the vertical (y) value in the TOPMARGIN subcommand within this 
page definition. 


Specifies the layout is to be positioned down (on the logical page) 
one line (as defined in the LINESP subcommand of the last 
SETUNITS command) from the previous field. The LINESP 
subcommand of the SETUNITS command establishes the distance 
from one line to the next. 


When NEXT is specified for the first XLAYOUT of a logical page, 
the starting position of the line is one line down from the top of the 
logical page, as defined by the TOPMARGIN subcommand. 


Notes: 


1. The “down” direction is determined by the direction of the 
logical page (as specified in the page format), not the 
XLAYOUT direction. NEXT is, therefore, mainly useful in 
ACROSS XLAYOUTSs. 
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2. For additional details on this area, please refer to the URL: 
http://www. ibm.com/printers/R5PSC.NSF/Web/ppfaupdt 


SAME Specifies this XLAYOUT starts at the same vertical position as the 
previous XLAYOUT. 


= Alternate for SAME. 
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Specifies the name of an object that is to be positioned and oriented relative to the 
location specified in the XLAYOUT command in which the OBJECT subcommand was 
named. The OBJECT, as identified by the internal-name parameter, must have been 
defined by an OBJECT command. You may place multiple objects on the same XLAYOUT 
command and you may place the same object multiple times. Each placement must have 
its own set of placement parameters, as follows: 


internal-name 
Specifies the name of an object that is up to 16 alphanumeric characters in length. 
The internal-name is used to match the XLAYOUT OBJECT subcommand to its 
definition from the OBJECT command. An object must be defined with this internal 
name by the OBJECT command. 


relative-xpos relative-ypos 
Specifies the number of units (inches, mm, and so on) that are added to the 
position of the current XLAYOUT to position the top-left corner of the object. The 
values for the horizontal and vertical positioning are limited by the type of printer 
used and the L-units specified with the PELSPERINCH parameter on the 
PAGEDEF or PAGEFORMAT command. 


Each position specification can be a positive or negative number with up to three 
decimal places. The units specified can be one of the following: IN, MM, CM, 
POINTS, or PELS. 


OBSIZE 
Specifies the size of the object placement area. When no OBSIZE is specified, the 
default is the size specified in the object. If no size is specified in the object, the 
size of the page is used. The page width is as specified on the PAGEDEF or 
PAGEFORMAT commands, or it defaults to 8.3 inches by 10.8 inches. 


wd Specifies the width of an object placement area as a number with 
up to three decimal places. The allowable width may vary with the 
type of printer used and the L-units specified with the 
PELSPERINCH parameter on the PAGEDEF or PAGEFORMAT 
command. 


hg Specifies the height of the object placement area as a number 
with up to three decimal places. The allowable height may vary 
with the type of printer used and the L-units specified with the 
PELSPERINCH parameter on the PAGEDEF or PAGEFORMAT 
command. 


unit Specifies a unit of measurement for the width parameter. The 
choices are: IN, MM, CM, POINTS, or PELS. 


Note: If no unit is specified, the default is the most recent 
SETUNITS command value or IN (inch) if a SETUNITS 
command has not been issued. 


USEOBJ Specifies that the size measurements specified in the object are to 
be used. If no size is specified in the object, the size of the page 
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is used, which is the length and width as specified on the 
PAGEDEF or PAGEFORMAT commands, or it defaults to 8.3 
inches by 10.8 inches. 


OBMAP 


Specifies mapping options. The OBMAP parameter defines the mapping of the 
object to the object placement area. If OBMAP is not coded, the mapping option 
within the object is used. If the object does not contain a mapping option, then the 
print server sets it to the created default for the container type. 


Each object type (OBTYPE on the OBJECT command) dictates the allowable 
mapping options for that type. When it can, PPFA issues a message when these 
rules are violated. However, in the case of an object type of page segment 


(OBTYPE=PSEG), PPFA does not know what types of objects are contained in it; 
therefore, PPFA cannot enforce the restrictions. See|“OBJECT Command 
(Traditional)” on page 235}for a description of the restrictions. 


LEFT Specifies that the object is positioned at the upper, left-hand 
corner of the object placement area, as defined or defaulted by 
the relative-xpos, relative-ypos, OBCHPOS, and OBCVPOS 
parameters. Any portion of the object that falls outside the object 
placement area as defined by the OBSIZE parameter is not 
trimmed and could cause an exception condition by the 
presentation system. 


TRIM Specifies position and trim. The object is positioned at the upper, 
left-hand corner of the object placement area, as defined or 
defaulted by the relative-xpos, relative-ypos, OBCHPOS, and 
OBCVPOS parameters. Any portion of the object that falls outside 
the object placement area as defined by the OBSIZE parameter is 
trimmed. 


FIT Specifies scale to fit; this is the default value if the OBMAP 
parameter is not coded. The object is to be scaled to fit within the 
object placement area, as defined by the OBSIZE parameter. The 
center of the object is placed in the center of the object placement 
area and the object is scaled up or down to fit the block. Scaling 
in the horizontal and vertical directions is symmetrical. The FIT 
parameter ensures that all of the data in the object is presented in 
the object placement area at the largest possible size. The object 
is not trimmed. 


CENTER Specifies that the center of the object be positioned at the center 
of the object placement area. Any portion of the object that falls 
outside the object placement area is trimmed. 


REPEAT Specifies that the origin of the data object be positioned with the 
origin of the object placement area. The object is then replicated 
in the X and Y directions. If the last replicated data does not fit in 
the object area, it is trimmed to fit. 


FILL Specifies that the center of the data object be positioned 
coincident with the center of the object placement area. The data 
object is then scaled, so that it totally fills the object placement 
area in both the X and Y directions. This may require that the 
object be asymmetrically scaled by different scale factors in the X 
and Y directions. 
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OBCHPOS 
Specifies the horizontal offset of the object contents within the object placement 


OVERLAY 
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area aS a number. 


X-pos Specifies a positive or negative number. The valid options for 
X-pos are described in the SETUNITS command for the horizontal 
value. 

USEOBJ Specifies that the offset value from the object is to be used. If no 


value is set in the object, the value defaults to 0. 


OBCVPOS 
Specifies the vertical offset of the object contents within the object placement 
area, as defined by the OBSIZE parameter. If OBCVPOS is not specified, it 
defaults to USEOBJ and uses the value set in the object. If no value is set in the 
object, the value defaults to 0. The OBCHPOS parameter is used only in LEFT 
and TRIM mapping of the object into the object placement area. 


y-pos Specifies a positive or negative number. The valid options for 
y-pos are described in the SETUNITS command for the vertical 
value. 

USEOBJ Specifies that the offset value from the object is to be used. If no 


value is set in the object, the value defaults to 0. 


OBROTATE {019011801270} 
Specifies the object rotation with respect to the current LND’s coordinate system. 


OBCOLOR colorname 
Specifies the color to be used as the default color or initial color for the object 
placement area. The OBCOLOR parameter is used only for objects of the PSEG, 
GOCA, BCOCA, and IOCA type. If the object type is OTHER, this parameter is 
ignored. Colors specified must be of the standard OCA color space. 


colorname Specifies standard OCA color space color names, which are: 


NONE 

DEFAULT 

BLACK 

BLUE 

BROWN 

GREEN 

RED 

PINK (or MAGENTA) 

TURQ (or CYAN) 

YELLOW 

DARKBLUE (or DBLUE) 
ORANGE 

PURPLE 

MUSTARD 

GRAY 

DARKGREEN (or DGREEN) 
DARKTURQ (DTURQ, or DARKCYAN, or DCYAN) 


Specifies the name of an overlay that is to be positioned relative to the location specified 


in the XLAYOUT command in which the OVERLAY subcommand was named. The 

PAGEFORMAT OVERLAY command may contain the named overlays. The maximum 
number of overlays specified for a PAGEFORMAT including the XLAYOUT OVERLAY 
subcommand is 254. 


Specifies the electronic overlay that is to be used with this subgroup. 
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name Specifies the user-access name as defined in the OVERLAY command. 


Notes: 


1. PPFA checks for duplication of local names. If there is a duplication, the page 
definition is generated, but a warning message is issued. 


2. PPFA does not check for duplicate user-access names. 


relative-xpos relative-ypos 
Specifies the number of units (inches, mm, and so on) that are added to the 
position of the layout to position the top-left corner of the overlay. The values for 
horizontal and vertical may be (+) or (—). The maximum value is + or — 32760 
L-units. For example: 
* OVERLAY NAME1 2 in 1 in 
* OVERLAY NAME2 5 mm 1mm 


Note: Any offset coded in the overlay itself is added to this offset. 


OVROTATE {019011801270} 
Specifies the rotation of the placed overlay with respect to the x-axis of the page. 


See FORMDEF Command” on page 185|for an OVROTATE example, which is 


presented in the FORMDEF description. 


Specifies the name of a segment that is to be positioned relative to the location specified 
in the XLAYOUT command in which the SEGMENT subcommand was named. The 
PAGEFORMAT SEGMENT command may contain the named segments. The maximum 
number of segments specified for a PAGEFORMAT including the XLAYOUT SEGMENT 
subcommand is 127. 


Specifies the page segment that is to be used with this subgroup. 
name Specifies the user-access name as defined in the SEGMENT command. 


Notes: 


1. PPFA checks for duplication of local names. If there is a duplication, the page 
definition is generated, but a warning message is issued. 


2. PPFA does not check for duplicate user-access names. 


relative-xpos relative-ypos 
Specifies the number of units (inches, mm, and so on) that are added to the 
position of the layout to position the top-left corner of the page segment. The 
values for horizontal and vertical may be (+) or (—). The maximum value is + or - 
32760 L-units. For example: 
* SEGMENT MYSEG1 2 in 1 in 
* SEGMENT MYSEG1 5 mm 1 mm 


Example of printing XML data with a page definition 


DATA: 
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<customer type='Home'> 
<name> 
<first>Justin</first> 
<last>Case</last> 
</name> 
<address> 
<strno>123</strno> 
<street>Redlight Lane</street> 
<city>Twistnshout</city> 
<state>MAMassachusetts</state> 
<zip>01050</zip> 
</address> 
</customer> 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| <customer type='Work'> 

| <name> 

| <first>Anna</first> 

| <last>Merkin</last> 

| </name> 

| <address> 

| <strno>1911</strno> 

| <street>Colt Lane</street> 
| <city>Longmont</city> 

| <state>C0Colorado</state> 
| <zip>80501</zip> 

| </address> 

| </customer> 


Figure 120. Example of printing XML data with a page definition (part 1) 
RESULTS: Using the following page definition and the XML data in|Figure 120}! want to print: 


Home customer: Justin Case 123 Redlight Lane 
Twistnshout, MA 01050 


Work customer: Anna Merkin 1911 Colt Lane 
Longmont, CO 80501 


| Figure 121. Example of printing XML data with a page definition (part 2) 
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PAGE DEFINITION: 


SETUNITS 1 IN 1 IN LINESP 6 LPI; 
XMLxml replace yes UDType EBCDIC; 
E21HOC TYPE EBCDIC; 

cust QTAG 'customer'; 
name QTAG 'customer','name'; 

fname QTAG 'customer','name','first'; 
Iname QTAG 'customer','name','last'; 

addr QTAG 'customer','address'; 

strno QTAG 'customer','address','strno'; 
street QTAG 'customer','address','street'; 
city QTAG 'customer','address','city'; 
state QTAG 'customer','address','state'; 
zip QTAG 'customer','address','zip'; 


Pagedef 
FONT 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 


XLAYOUT 
FIELD 
FIELD 

XLAYOUT 

XLAYOUT 

XLAYOUT 

XLAYOUT 
FIELD 
FIELD 

XLAYOUT 
FIELD 
FIELD 

XLAYOUT 
FIELD 
FIELD 

XLAYOUT 


cust POSITION 
ATTR 'type' ; 
TEXT ' customer: 
fname POSITION 
Iname POSITION 
strno POSITION 
street POSITION 
TEXT '' ' 

START 1 LENGTH 
city POSITION 
START 1 LENGTH 
TEXT ss 
state POSITION 
START 1 LENGTH 
TEXT ' '3 

zip POSITION 
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ABSOLUTE 0 

ABSOLUTE 2.5 SAME; 
RELATIVE 0.167 SAME; 
ABSOLUTE 5.5 SAME; 
RELATIVE 0 SAME; 
*; 

ABSOLUTE 5.5 NEXT; 
*; 

RELATIVE 0 SAME; 
23 

RELATIVE 0 SAME; 


Figure 122. Example of printing XML data with a page definition (part 3) 
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Appendix A. System Dependencies for PPFA 


PPFA is a cross system product that operates on: 

* VSE (Virtual Storage Extended) 

* OS/390 (Operating System 390) 

¢ VM (Virtual Machine) 

¢ AIX (Advanced Interactive Executive) 

* OS/400 (Operating System 400) 

¢ Windows NT and Windows 2000 Operating Systems 


For the level of the operating system on which PPFA can run, refer to the Licensed Program Specification. 


PPFA creates page definitions and form definitions used for printing by PSF/OS/390, PSF/VM, and 
OS/400. PPFA creates a data base file member containing AFPDS that can be used to create the OS/400 
objects PAGDFN and FORMDF, using the CRTPAGDFN and CRTFORMDFN commands. Page definitions 
and form definitions created on one system can be used for printing on another system. However, not all 
versions of print servers support all functions provided by PPFA. Use the Programming Guide or User’s 
Guide for your print server system to determine which functions are supported by your system. 


While page definitions and form definitions created on one system can be used on any of the systems, the 
method of creating these resources is different. 


Each system is presented to show how PPFA creates page definitions and form definitions. In the 
examples, the prefixes F1 and P1 are automatically added by PPFA to the user name designated for form 
definitions and page definitions. 


VSE Environment 


PPFA can operate in any partition of VSE. It operates in batch mode but is able to operate in a partition 
occupied by an interactive processor. 


Storing PPFA Resources 


Form definitions and page definitions are stored by name in a library. In VSE, sub-libraries are created for 
form-definition and page-definition storage within the system library. 


The following job control statements (JCS) give an example of a PPFA execution under VSE. The 'C’ in 
Column 72 indicates a continuation. 


72 Column 
* $$ JOB 
// CLASS=0 
// JOB PPFAEXEC v 
// ASSGN SYSLST,OOE C 


// OPTION DUMP 
// LIBDEF PHASE, SEARCH=(ppfa.program) , TEMP 
// EXEC PGM=AKQPPFA,SIZE=AUTO, 
PARM='FORMLIB=ppfa. formdef , PAGELIB=ppfa.pagedef ,C 
size=128K' 


PPFA control statements ) 


) 
> SYSIPT file 
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Rules for VSE 


The rules for VSE commands in a PPFA execution follow: 


¢ All characters in the EXEC statement parameters must be uppercase. Each keyword in a parameter 
must be unique; PPFA issues an error message if any keywords are duplicated. 


¢ AKQPPFA is the program name. 
* SIZE= is the maximum available storage in the program. The SIZE parameter is not used to specify a 
PPFA work area size. 
* PARMz= is used to input PPFA parameters. 
— FORMLIB= (or PAGELIB=) libraryname.sublibraryname 
- All library names are alphanumeric (1 to 7 characters); the first character must be alphabetic. 
- All sublibrary names are alphanumeric (1 to 8 characters) including the first character. 
— size=nnK or nnnM 
- Defines the work area in which PPFA compiles the page definitions and form definitions. The 
default is 128k and the minimum 4K. 
* The format for the FORMLIB or PAGELIB parameters is: 
— FORMLIB= (or PAGELIB=) libraryname.sublibraryname, where library names are 1 to 7 characters 
long and sublibrary names are 1 to 8 characters long. 
— All characters (library and sublibrary names) are alphanumeric, except that the first character must 
be alphabetic. 


¢ Libraries must be defined prior to PPFA execution; Otherwise, an ABEND occurs. PPFA can perform a 
syntax check without libraries being defined, but it cannot define its own libraries; 


¢ The SYSIPT file drives PPFA. It contains the commands used to build form definitions and page 
definitions. The records are fixed-length records of either 80 or 81 bytes, which can be blocked. The last 
8 bytes of the records are treated as comments. 


OS/390 Environment 


The following example shows you how to create page definitions and form definitions in the OS/390 
environment. 


Form definitions and page definitions are stored by name in a library. 


PPFA for OS/390 is run as a batch program with Job Control Language (JCL). The JCL statements are an 
example of PPFA execution under OS/390: 

//JOBPPFA JOB TOKYO 

//STEP EXEC PGM=AKQPPFA 

//STEPLIB DD DSN=ppfa. program, DISP=SHR 

//SYSPRINT DD SYSOUT=A 

//FORMLIB DD DSN=ppfa. formlib,DISP=SHR 

//PAGELIB DD DSN=ppfa.pagelib,DISP=SHR 

//SYSIN DD « 


PPFA control statements 


[x 


The SYSIN file contains the commands used to build form definitions and page definitions. The records 
can be fixed length or variable length, and they can be blocked. The maximum length for fixed-length 
records is 100 bytes; the maximum length for variable-length records is 104 bytes. In the case of fixed 
80-byte records, the last 8 bytes are treated as comments. 
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The record format for the page-definition and form-definition data sets must be variable blocked (VBM). 
The block size and record length must be 8209 and 8205. PPFA uses all of the available storage in the 
program. 


Note: When concatenating multiple data sets in the SYSIN data definition, you must ensure that the data 
set with the largest block size is first in the concatenation order. Otherwise, the output may not be 
what you expect. 


VM Environment 


To create a page definition and form definition running PPFA under VM, use the following command 
syntax: 


Note: The defaults require only filename (fn) and filetype (ff) for your PPFA source file. 


PPFA fn ft [ fm] [ ( [PAGEDEF ( ft [ fm | Al] ) 
[FORMDEF ( ft [ fm | Al ] ) 
[LISTING ( ft [ fm | A1 ] ) 
[SIZE nnnn{K|M} ] ) J] 


ray 


PPFA is the command to run PPFA on VM. The filename (fn) is the name of your file that contains the 
PPFA control statements. The filename (fn) and filetype (ff) are required parameters. When you specify 
only the fn and ft, the filemode goes to your default disk. 


The record format of the PPFA input source file is either V or F. The variable record length is a maximum 
of 100 bytes. In the case of a fixed 80-byte record, the last 8 bytes are treated as comments. 


The PPFA command may include any of four optional parameters: PAGEDEF, FORMDEF, LISTING, and 
SIZE. 


¢ Each keyword parameter can be abbreviated as two letters. 


¢ All parameters in the command can be omitted. However, any optional parameter following an open 
parenthesis must be specified. 


* Operands must be enclosed in parentheses when more than one operand is specified for one 
parameter. Parentheses can be omitted when only one operand is specified for one parameter. Also, the 
final closing parenthesis can be omitted. 


¢ Any operand string longer than eight characters is truncated to the first eight characters. 


¢ Any parameter or operand can be separated from others by parentheses or blanks. The only exceptions 
are the K and the M operands of a size parameter. For example, in size 256K you cannot separate the 
256 from the K. 


* The same parameter must not be specified more than once in a command. If duplicate parameters or 
operands appear, PPFA issues an error message and terminates the program. 


* For errors associated with a VM execution command, PPFA issues an error message with a return code 
20, and does not generate any files (object or listing). 


* No optional parameters can follow the open parenthesis occurring after the input source file ID. 


* The size parameter varies according to the size of the command stream. Most command streams do 
not need a size value because the default specifies enough space for processing. 


PAGEDEF Parameter 


PAGEDEF (which can be abbreviated as PA) is the keyword used to specify the name of a page-definition 
resource. (The filetype is required; the filemode is optional. If you do not specify a filemode, A1 is 
assumed.) The page-definition filename is obtained from your input file, and P1 is prefixed to that name. 


As an example, for the command 
PPFA PCOM DATA Al ( PAGEDEF ( PAGEOBJ B1 ) ) 
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the input file, PCOM DATA A1, contains the following control statements: 


PAGEDEF PAGE1; 
PRINTLINES 
FORMDEF FORM1; 


The result is a page-definition resource file with the filename P1PAGE1, the filetype PAGEOBJ, and the 
filemode B1. 


If the page definition parameter is not used, a page-definition resource with the default name P1 (the page 
definition name from input file) PDEF38PP A1 is created. 


The record format of the object file is VM and VA (5A records). 5A records contain the character X'5A' in 
the first byte of each record. The record size is up to 8205 bytes. 


FORMDEF Parameter 


FORMDEF (which can be abbreviated as FO) is the keyword used to specify the name of a form-definition 
resource. (The filetype is required; the filemode is optional.) The filename is obtained from your input file, 
and F1 is prefixed to that name. As an example, for the command 


PPFA PCOM DATA Al ( FORMDEF ( FORMOBJ B1 ) ) 


the input file, PCOM DATA A1, contains the following control statements: 


PAGEDEF PAGE1; 
PRINTLINES 
FORMDEF FORM1; 


The result is a form-definition resource file with the filename F1FORM1, the filetype FORMOB4J, and the 
filemode B1. 


If the form-definition parameter is not used, a form-definition resource with the default name F1 
(form-definition name from input file) FDEF38PP A1 is created. 


The record format of the object file is VM and VA (5A records). The record size is up to 8205 bytes. 


LISTING Parameter 


LISTING (which can be abbreviated as LI) is the keyword used to specify the name of an output listing file. 
You can specify the filetype and filemode of the resource; the filetype is required. If you do not specify a 
filemode, A1 is assumed. The filename is the same as the PPFA input filename. 


As an example, for the command 
PPFA PCOM DATA Al ( LISTING ( LISTOUT B1 ) 


the result is an output listing file with the name PCOM LISTOUT B1. 


If the LISTING parameter is not used, an output listing file with the default name (PPFA input filename) 
LISTING A1 is created. 


The record format of an output listing file is VA. The record length is 121 bytes (120 bytes + 1 byte 
(channel control number)). CC numbers are 0 to 12 in the first column of the line data file. 


RUN and OPTIONS file 


This is an example of the VM files that print your data file with the form definition and page definition that 
you specify. 
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r— VM EXEC Example 


KKKKKKKKKKK KKK KKK KKK KK EKER KKK KKK KKK KKK K KKK KERR KK KEK KKK KKK KKK EKEKEKKKKKKKKK 


/*THE ENVIRONMENT IS NOW SET UP TO PRINT */ 

*CP SP PRT TO NET NOHOLD CLASS A FORM PRT035 COPY 1’; 

CP TAG DEV PRT WASVM SYSTEM’; 

’PSF EXAMP1 PRTDATA A1 ( OPTIONS (EXAMP1) )’; 

/*RESTORE THE ENVIRONMENT TO PRINT SOMETHING OTHER THAN THIS EXAMPLE*/ 


KRKKKKKEKKKK KEKE KKK KKK KEKE KKK KKK KKK KKK KEKE KKK KKK EKKK EKER KERR KKEKKEKKKKK 


r— VM OPTIONS Example 


KKRKKKKKKKKK KKK KKK KK KK KEKE KK KKK KKK KEKE KKK KKK KKK ER KK KKK KKK KEKREKKKKKKKKK 


FORMDEF ( F1EXAMP1 FDEF38PP  ) SEND 


KKRKKKKKKKEKK KKK KKK KKK KK KEKE KKK KKK KKK KKK K KKK KERR KEKE KR KK KKK KKK KEKREKKKKKKKKEK 


PAGEDEF ( P1EXAMP1 PDEF38PP _ ) SYSDISK 


KKRKKKKKKKEKK KKK KKK KKK KK EKER KK KKK KK KK KKK KKK KR KK KK ER KKK KKK KK KEKREKKKKKKKKK 


OVERLAY ( * OVLY38PP ) SYSDISK 


KRKKKKKEKKEKKKKEKEK KKK KKK KERR ERK KKK KK KKK RE K KEKE KKK KKK EKKKKEKKEKKKEKREKKEKKEKKKKK 


* COMMON OPTIONS 

cc 

NOTRC 

BIN 1 

CKPTPAGE 0 

DATACK UNBLOCK 

NODUMP 

FILE SEND 

FONT  ( * FONT3820 ) SYSDISK 
MESSAGES NO 

NOOPT 

PAGESEG ( * PSEG38PP_ ) SYSDISK 
TRACE OFF 


KKKKKKKKKEKK KKK KKK KEKE KEKE KKK KKK KKK KERR KKK KKK KKK KER KKK KK KKK KEKRKEKKKKKKKKK 


AIX Environment 


The ppfa command creates form definitions and page definitions on the AIX operating system. After they 
are created, you can transfer the form definitions and page definitions to other operating systems (such as 
OS/390, VM, or VSE) to use as AFP resources. 


Syntax 
ppfa [ -fpath.ext | [ -ppath.ext | [ -spath.ext ] [ -x ] inputtfile 


Flags and Values 
You can specify these flags and values with the ppfa command. 


inputtile 
The file containing the PPFA source statements to be “processed”. 
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-fpath.ext 


Add path and extension information to the names of form definitions generated by PPFA. (The actual 
name of the form definition comes from the FORMDEF command in the PPFA source. ) 


-ppath.ext 


Add path and extension information to the names of page definitions generated by PPFA. (The actual 
name of the page definition comes from the PAGEDEF command in the PPFA source.) 


-spath.ext 


—-X 


Add path and extension information to the listing file. The name of the listing file is the same as the 
name of the input file. 


Thus, for “FORMDEF name” when PPFA was invoked with: 
ppfa -fpath.ext infile 


it generates form definition: 
/path/name.ext 


Also, for “PAGEDEF name” when PPFA was invoked with: 
ppfa -p/root/abc/def.xyz.nnn infile 


it generates page definition: 
/root/abc/def.xyz/name.nnn 


In another example, if you enter: 
ppfa -pabc/def.xyz input. file 


and it has a PAGEDEF statement in the source, then the page definition created is either: 
abc/def/P1NAME.xyz 


or 
./abc/def/P1NAME. xyz 


However, if you enter: 
ppfa -p/abc/def.xyz input. file 


PPFA generates the file: 
/abc/def/Piname. xyz 


not 
.//abc/def/P1name. xyz 


Causes ppfa to interpret information found in columns 1-72 of the inputfile. The information in the rest 
of the columns is ignored. This is useful if you are downloading a Fixed-80 file from the host. 


Examples 


i; 


To create a form definition from an input file called johnb in the current library containing the PPFA 
source statements, enter: 


ppfa johnb 


The generated form definition is stored in the current library. 


To create a form definition from an input file called marye containing the PPFA source statements, and 
then storing the generated form definition in the /usr/lpp/resources library, enter: 


ppfa -f/usr/lpp/resources maryc 
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Files 
/usr/lpp/ppfa/bin/ppfa PPFA program 


/usr/lpp/psf/ppfa Source code for the form definitions and page definitions supplied with 
Infoprint Manager for AIX 


OS/400 Environment 


General Information 
Support has been added to give the OS/400 users full AFP function. 


Note: In this document, the following terms are used interchangeably: 
¢ *LINE and line data 

¢ *AFPDSLINE and mixed data 

¢ PAGDFN and page definition 

¢ FORMDF and form definition 


This section describes the following printer file attributes: 
¢ DEVTYPE 

* CTLCHAR 

* TBLREFCHR 

* AFPCHARS 

* PAGDFN 

* FORMDF 


This section also provides information about line data application considerations, device type 
considerations, OS/400 printer file parameters, carriage control characters (ANSI and Machine), Table 
Reference Characters, |GC parameters, Medium-Map-Name (INVMMAP) DDS keyword, restrictions when 
using PAGDFN and FORMDF, as well as information about the CVTPPFASRC command. 


DEVTYPE Values 


To place line data or mixed data onto the printer spool, specify either the *LINE or *AFPDSLINE values 
with the DEVTYPE parameter for the CRTPRTF, CHGPRTF and OVRPRTF CL commands. 


*LINE Line data is placed onto the spool. For *LINE, specify any of the following: 
* CTLCHAR(*FCFC) 
* CTLCHAR(*MACHINE) 
* CTLCHAR(*NONE) 


To place line data and skipping or spacing controls directly onto the printer spool without 
converting it to another data stream, specify *LINE. The line data is not in a printer-ready format 
and, like AFPDS, will be converted to the appropriate printer format at print time. 


*AFPDSLINE 
Line data and AFPDS (mixed data) is placed onto the printer spool. For *AFPDSLINE, specify any 
of the following: 
* CTLCHAR(*FCFC) 
* CTLCHAR(*MACHINE) 


You can specify page definitions to format traditional application line data without making any 
application programming changes. If, however, you want to use any one of the following AFPDS 
structured fields (which can be intermixed with line data), you must specify, in hex, a X'5A' record 
in the output buffer. Refer to Advanced Function Printing: Programming Guide and Line Data 
Reference , (S544-3884), for more information about mixed documents and MO:DCA. 

* Invoke Data Map 
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* Invoke Medium Map 

* Invoke Page Segment 
¢ Include Page Overlay 
¢ Presentation Text 


Refer to the Advanced Function Presentation Programming Guide and Line Data Reference 
(S544-3884) for more information about mixed data streams. 


CTLCHAR Values 


When machine code control characters exist in the data (rather than ANSI control characters), specify the 
CTLCHAR parameter with a value of *MACHINE on the CRTPRTF, CHGPRTF, or OVRPRTF CL 
commands. 


See |Table 24 on page 382) for information about machine code control characters. 


TBLREFCHR Parameter 


To indicate whether a table reference character (TRC) exists in the data, specify the TBLREFCHR 
parameter with the CRTPRTF, CHGPRTF, or OVRPRTF CL commands. 


If forms control characters are used with the data, the TRC follows the forms control character, but 
precedes the data bytes. If forms control characters are not used, the TRC is the first byte of the data 
record. As with forms control characters, if table reference characters are used, every data record must 
contain a TRC byte. 


Note: The TBLREFCHR parameter is ignored if specified for *USERASCII, *SCS, *IPDS, and *AFPDS 
device types. 


See|“Table Reference Characters (TRC)” on page 383] for more information. 


AFPCHARS Parameter 


To identify up to four 4-byte names of coded fonts, specify the AFPCHARS parameter with the CRTPRTF, 
CHGPRTF, or OVRPRTF CL commands. The 4-byte names are concatenated to ‘XO’ to identify up to four 
coded fonts that are needed when TBLREFCHR is used within the data. 


PAGDFEN Parameter 


To use or identify a fully-qualified page definition, specify the PAGDFN parameter with the CRTPRTF, 
CHGPRTF, or OVRPRTF CL commands. 


A page definition is an AFP resource object that allows line data and mixed data to be formatted, 
independent of the application. You can specify page definitions with *LINE or *AFPDSLINE data. After 
PSF/400 completes formatting, it converts the line data and page definition to IPDS. 


Whenever you specify line data or mixed data through NJE or PrintManager/400, with output directed to 
an AFP printer but do not specify a page definition, an inline page definition is built from the print 
parameters and passed to PSF/400. 


Depending upon the specifications given, some printer file parameters may be ignored when the spooled 
file is printed through PSF/400. For example, if you specify a page definition on the CRTPRTF, 
CHGPRTF, or OVRPRTF CL command, and also specify line data or mixed data, an inline page definition 
will not be built from the printer file parameters. In this case, if you send the data to an AFP printer, 
PSF/400 ignores the following print parameters: 

* CDEFNT 

* CHRID 

* CPI 
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* FNTCHRSET 
* FOLD 

* FONT 

° LPI 

¢ MULTIUP 

* PAGESIZE 

* PAGRTT 

* REDUCE 


However, in this example, if you send the data to a non-AFP printer with a devtype of *LINE, the page 
definition parameter is ignored and the print parameters are used. The line data is converted to SCS or 
IPDS. 


If you specify a page definition, but do not specify a form definition, an inline form definition is built from 
the appropriate printer file parameters, including: 

* DRAWER 

* DUPLEX 

* FORMFEED 

¢ PAGRTT 

* PRTQLTY 


FORMDF Parameter 


To use or identify a fully-qualified form definition, specify the FORMDF parameter with the CRTPRTF, 
CHGPRTF or OVRPRTF CL commands. 


A form definition is an AFP resource object that defines the characteristics of the form, including: 
* overlays 

* position of page data on the form 

* rotation 

* modification to pages 


You can specify a form definition with the following data: 
* *AFPDS 

¢ *AFPDSLINE 

° *LINE 

* *IPDS 

* *SCS 


PSF/400 accepts *AFPDS, *AFPDSLINE, and *LINE data, and requires a form definition to print. (When 
you specify an AFP printer, the *IPDS and *SCS data streams are converted to AFPDS.) 


Whenever you specify any output directed to an AFP printer but do not specify a form definition, an inline 
form definition is built from the print parameters and passed to PSF/400. 


Depending upon the specifications given, some printer file parameters may be ignored when output is 
printed through PSF/400. For example, if you specify a form definition on the CRTPRTF, CHGPRTF or 
OVRPRTF CL command and also specify line data or mixed data, an inline form definition will not be built 
from the printer file parameters. In this example, if you send the data to an AFP printer PSF/400 ignores 
the following printer file parameters: 


* BACKMGN 

* CORNER STPL 
* DRAWER 

* DUPLEX 

* EDGESTITCH 
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- FORMFEED 

- FRONTMGN 

* MULTIUP (N_UP) 
* PAGRTT 

* PRTQLTY 

* REDUCE (N_UP) 
* SADLSTITCH 


However, if you send the data to a non-AFP printer with a devtype of *IPDS or *SCS in this example, the 
form definition parameter is ignored and the printer file parameters are used. 


When specifying a form definition on the printer file, the values you specify on the DRAWER and DUPLEX 
parameters will override the drawer and duplex values specified in the form definition. If you want to use 
the drawer and duplex values specified in the form definition, you must specify DRAWER(*FORMDF) and 
DUPLEX(*FORMDF) on the printer file. 


To indicate an output bin for a form definition, specify the OUTBIN parameter on the print file. 


Application Considerations for Line Data 


Line data and mixed data on OS/400 are used by OS/390 AFP users who are migrating data to OS/400 
and OS/400 users who are generating AFPDS, IPDS, or SCS data streams. 


If you are a OS/390 user, you should be familiar with the concepts of AFP and page definitions. When 
using line data, page definitions, and form definitions, your applications are generating line data with either 
an ANSI or machine code control character in column 1 of the spooled output. To migrate data to OS/400 
prior to OS/400 Version 3, Release 2, and Version 3, Release 7, OS/390 users had to use 
PrintManager/400 API calls to rewrite their applications. With line data support, applications do not need to 
be rewritten. To migrate data to OS/400, specify CTLCHAR(*FCFC) for ANSI code control, or 
CTLCHAR(*MACHINE) for machine code control. You should also specify DEVTYPE(*LINE) or 
DEVTYPE(*AFPDSLINE). 


If you are an OS/400 user, and want to use line data, page definitions, and form definitions, you must 
determine whether your application generates an ANSI control character in column 1 of your spooled 
output. 


If your application does generate an ANSI control character in column 1 of your spooled output to control 
skipping and spacing, specify CTLCHAR(*FCFC) on the printer file. Also, to convert to line data, specify 
the following in the OS/400 printer file: 


¢ DEVTYPE(*LINE) 
¢ PAGDFN (a page definition) 
* FORMDF (a form definition) optional format 


Note: Specifying a form definition in this format is optional; you could specify that an inline form definition 
be built from the print file parameters by indicating FORMDF(*NONE) on the OS/400 printer file. 


You can change your application to place an ANSI control character in column 1 of your spooled output to 
control skipping and spacing, by using a language or application construct (such as a SKIP or SPACE 
option on a COBOL WRITE statement), or by making an RPG output specification. 


When you specify a device type of *AFPDS, *IPDS, or *SCS, control information is used to generate the 


appropriate skipping or spacing commands in the specified data stream. The control information for 
*AFPDS and *LINE that is passed by the compilers and application is converted to a machine code control 
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character. Thus, applications that do not use ANSI control characters can generate line data with control 
characters onto the spool and use a page definition for post spool formatting, if you specify 
CTLCHAR(*NONE) and DEVTYPE(*LINE). 


The system will insert ANSI control characters into column 1 and change the spooled file attributes to 
CTLCHAN (*FCFC). 


Device Type Considerations 
When using line data, you can specify various combinations of DEVTYPE(*LINE), PAGDFN and FORMDF 
parameter support on the print file. For example: 
¢ Specify DEVTYPE(*LINE), PAGDFN, and FORMDF 
— When you print to an AFP printer, PSF/400 uses the PAGDFN and FORMDF parameters to 
transform the data to IPDS. 


— When you print to a non-AFP printer, the PAGDFN and FORMDF parameters are ignored. The 
parameters on the print file are used, and the line data is transformed to IPDS or SCS. 


* Specify DEVTYPE(*LINE), no PAGDFN, with FORMDF 


— When you print to an AFP printer, an inline page definition is built from the print file parameters. 
PSF/400 uses the inline page definition and user-specified FORMDF parameter to transform the data 
to IPDS. 


— When you print to a non-AFP printer, the FORMDF parameter is ignored. The print file parameters 
are used, and the line data is transformed to IPDS or SCS. 


* Specify DEVTYPE(*LINE), PAGDFN, no FORMDF 


— When you print to an AFP printer, an inline form definition is built from the print file parameters. 
PSF/400 uses the user-specified PAGDFN parameter and the inline form definition to transform the 
data to IPDS. 


— When you print to a non-AFP printer, the PAGDFN parameter is ignored. The print file parameters 
are used, and the line data is transformed to IPDS or SCS. 


* Specify DEVTYPE(*LINE), no PAGDFN, no FORMDF 


— When you print to an AFP printer, an inline PAGDFN and FORMDF is built from the print file 
parameters. PSF/400 uses the inline page definition and inline form definition to transform the data 
to IPDS. 


— When you print to a non-AFP printer, the print file parameters are used, and the line data is 
transformed to IPDS or SCS. 


The support for combinations of PAGDFN and FORMDF for DEVTYPE(*AFPDSLINE) are similar to 
DEVTYPE(*LINE) line data. However, you should be aware of the following exceptions: 


¢ When you send data to a non-AFP printer, the data can not be transformed to IPDS or to SCS. The 
spooled file must be printed on an AFP printer. 


* Although you are not required to specify PAGDFN or FORMDF with *AFPDSLINE data "4, certain 
AFPDS commands in the data stream (for example, Invoke Medium Map) may reference named 
structured fields in the PAGDFN or FORMDF that may not match those in the inline PAGDFN and 
FORMDF. 


The following parameters for line data can be changed with the CHGSPLFA command, after the data is 
spooled and before the spool file is printed: 

¢ AFPCHARS 

* FORMDF 

* PAGDFN 


14. You are not required to specify PAGDFN or FORMDF with *AFPDSLINE data because it can be built inline from a print file. 
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OS/400 Printer File Parameters 


The following table summarizes the print file keyword support provided when line data or mixed data is 


specified. 


Support of OS/400 printer file parameters 


When line data is redirected to a non-AFP printer, the attribute of the print file is used to print the file. 


Note: Line data (*LINE) specified with a page definition or mixed data can not be redirected. 


The following table summarizes the support for print file keywords when Line data or Mixed data is 


specified. 


Table 22. OS/400 Printer File Parameter Table 


Print keyword 


Line data or Mixed data specified 


AFPCHARS Is supported when printing to an AFP printer. 
Ignored when line data is redirected to a non-AFP printer. 

ALIGN Is supported 

CTLCHAR Is supported 

AUT Is supported 

BACKMGN Ignored when a FORMDF is specified and printing to an AFP printer. Margin offset 
information is specified in the FORMDF. 
Used when printing to an AFP printer and no FORMDF is specified. Inline FORMDF is 
built from print parameters. 
Valid only with *AFPDS data stream. 

BACKOVL Is supported. 
Ignored when print file (IPDS) is redirected to a non-AFP printer. 

CDEFNT Ignored when a PAGDEN is specified and printing to an AFP printer. Font is gotten 
from AFPCHARS parameter or is specified in PAGDFN. 
Used when printing to an AFP printer and no PAGDEN is specified. Inline PAGDFN is 
built from print parameters. 

CHLVAL Is ignored. The PAGDFN contains information for mapping channel numbers to line 
numbers. 

CHRID Ignored when a PAGDEN is specified and printing to an AFP printer. Code page is 


gotten from AFPCHARS parameter or is specified in PAGDFN. 
Used when printing to an AFP printer and no PAGDEN is specified. Inline PAGDEFN is 
built from print parameters. 


COPIES Is supported 

CORNERSTPL Ignored when a FORMDEF is specified and pointing to an AFP printer. 
Used when printing to an AFP printer and no FORMDEF is specified. 

CPI Ignored when a PAGDEN is specified and printing to an AFP printer. Font is gotten 
from AFPCHARS parameter or is specified in PAGDFN. 
Used when printing to an AFP printer and no PAGDEN is specified. Inline PAGDFN is 
built from print parameters. 

CTLCHAR Is supported 

CVTCINDTA Is supported. Line data can be converted to AFPDS before it is placed onto spool. A 
page definition must be specified. The DEVTYPE is changed to *AFPDS. 

DEV Is supported 

DEVTYPE “LINE and *AFPDSLINE only 

DFRWRT Is supported 
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Table 22. OS/400 Printer File Parameter Table (continued) 


Print keyword 


Line data or Mixed data specified 


DRAWER Ignored when a FORMDF is specified and printing to an AFP printer. Drawer is gotten 
from FORMDF. 

Used when printing to an AFP printer and no FORMDF is specified. Inline FORMDF is 
built from print parameters (for SCS or IPDS data streams). 

DUPLEX Ignored when a FORMDF is specified and printing to an AFP printer. Duplex is gotten 
from FORMDF. 

Used when printing to an AFP printer and no FORMDF is specified. Inline FORMDF is 
built from print parameters (for SCS or IPDS data streams). 

EDGESTITCH Ignored when a FORMDEF is specified and pointing to an AFP printer. 

Used when printing to an AFP printer and no FORMDEF is specified. 

FIDELITY Is supported when printing to an AFP printer. 

Ignored when line data is redirected to a non-AFP printer. Default is content fidelity. 

FILE Is supported 

FILESEP Is supported 

FNTCHRSET Ignored when a PAGDEN is specified and printing to an AFP printer. Font is gotten 
from AFPCHARS parameter or is specified in PAGDFN. 

Used when printing to an AFP printer and no PAGDEN is specified. Inline PAGDFN is 
built from print parameters. 

FOLD Is ignored if a PAGDFN or FORMDF is specified and printing to an AFP printer 
because when PAGDFN or FORMDF is specified, the page size and where data is 
positioned on a page is unknown. 

FONT Ignored when a PAGDEFN is specified and printing to an AFP printer. Font is gotten 
from AFPCHARS parameter or is specified in PAGDFN. 

Used when printing to an AFP printer and no PAGDEN is specified. Inline PAGDFN is 
built from print parameters. 

FORMDF Is supported when printing to an AFP printer. 

Ignored when line data is redirected to a non-AFP printer. 

FORMFEED Ignored when a FORMDF is specified and printing to an AFP printer. FORMFEED is 
gotten from FORMDF. 

Used when printing to an AFP printer and no FORMDF is specified. Inline FORMDF is 
built from print parameters. 

FORMTYPE Is supported 

FRONTMGN Ignored when a FORMDF is specified and printing to an AFP printer. Margin offset 
information is specified in the FORMDF. 

Used when printing to an AFP printer and no FORMDF is specified. Inline FORMDFF 
is built from print parameters. 
Valid only with *AFPDS data stream. 
FRONTOVL Is supported. 
Ignored when print file (IPDS) is redirected to a non-AFP printer. 

HOLD Is supported 

LPI Ignored when a PAGDEN is specified and printing to an AFP printer. Lines Per Inch is 
gotten from PAGDFN. 

Used when printing to an AFP printer and no PAGDEN is specified. Inline PAGDFN is 
built from print parameters. 

LVLCHK Ignored. Line data and Mixed data are not valid with a DDS print file 

MAXRCDS Is supported 
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Table 22. OS/400 Printer File Parameter Table (continued) 


Print keyword 


Line data or Mixed data specified 


MULTIUP 


Ignored when a PAGDFN or FORMDF is specified and printing to an AFP printer. 
MULTIUP is specified in the FORMDF(N-UP) or can be achieved in the PAGDFN. 
Used when printing to an AFP printer and no FORMDF or PAGDEFN is specified. Inline 
FORMDF and PAGDEFN is built from print parameters. 


OPTION Is supported 
OUTBIN Is supported when printing to an AFP printer. 
Ignored when line data is redirected to a non-AFP printer 
OUTPTY Is supported 
OUTQ Is supported 


OVRFLW 


The overflow message will only be issued for Line data. It will not be issued for Mixed 
data. 


PAGDFN Is supported when printing to an AFP printer. 
Ignored when line data is redirected to a non-AFP printer. 

PAGERANGE Is supported 

PAGESIZE Ignored when a PAGDEN is specified and printing to an AFP printer. Page size is 
gotten from PAGDFN. 
Used when printing to an AFP printer and no PAGDEN is specified. Inline PAGDFN is 
built from print parameters. 

PAGRTT Ignored when a FORMDF is specified and printing to an AFP printer. Rotation is 
specified in FORMDF. 
Used when printing to an AFP printer and no FORMDF is specified. Inline FORMDF is 
built from print parameters (for SCS or IPDS data streams). 
lf PAGRTT(*COR) is specified, then this parameter is ignored unless both PAGDFN 
and FORMDF are not specified. 

PRTQLTY Ignored when a FORMDF is specified and printing to an AFP printer. Print quality is 
gotten from FORMDF. 
Used when printing to an AFP printer and no FORMDF is specified. Inline FORMDF is 
built from print parameters. 

PRTTXT If the file is opened *LINE and no PAGDFN is specified, print text will be supported. If 
the file is opened as *AFPDSLINE, print text will not be supported. 

REDUCE Ignored when a PAGDFN or FORMDF is specified and printing to an AFP printer. 
MULTIUP is specified in the FORMDF(N-UP) or can be achieved in the PAGDFN. 
Used when printing to an AFP printer and no FORMDF or PAGDEN is specified. Inline 
FORMDF and PAGDEFN is built from print parameters. 
REDUCE(*TEXT) is supported when printing to a non-AFP printer. 

REPLACE Is supported 

RPLUNPRT Is supported 

SADLSTITCH Ignored when a FORMDEF is specified and pointing to an AFP printer. 
Used when printing to an AFP printer and no FORMDEF is specified. 

SAVE Is supported 

SCHEDULE Is supported 

SCRFILE Ignored. Line data and mixed data are not valid with a DDS print file. 

SCRMBR Ignored. Line data and mixed data are not valid with a DDS print file. 

SHARE Is supported 

SPOOL *YES only. Direct |O (SPOOL(*NO)) is not supported. 

TBLREFCHR Is supported when printing to an AFP printer. 


Ignored when line data is redirected to a non-AFP printer (IPDS). 
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Table 22. OS/400 Printer File Parameter Table (continued) 


Print keyword Line data or Mixed data specified 

TEXT Is supported 

UOM Is supported 

USRDFNDTA Is supported when printing to an AFP printer. 
USRDFNOBJ Is supported when printing to an AFP printer. 
USRDFNOPT Is supported when printing to an AFP printer. 
USRDTA Is supported 

WAITFILE Is supported 


Carriage Control (CC) Characters 


The carriage control character can be represented as either ANSI or machine code. 


ANSI carriage control is a standard representation that is used with printers from many different 
manufacturers. |Table 23] lists the ANSI codes and their functions. Machine code control characters were 


defined by IBM; they correspond to channel command words issued by the operating system.|Table 24 on 
page 382 382 


lists the IBM machine code values and functions. 
Note: You may not use both ANSI and machine codes within a single data set. 


There are differences in the conventions used by OS/400 for ANSI and machine code line spacing. The 
OS/400 convention for ANSI handles line spacing and then causes the line to be printed. The OS/400 
convention for machine codes causes the line to be printed and then the spacing action is performed. 
ANSI Carriage Control Characters 

Table 23. ANSI Carriage Control Characters 


Hexadecimal Value Character Function 
X'40' (space) Space 1 line, then print (single spacing) 
X'FO' 0 Space 2 lines, then print (double spacing) 
X'60' - Space 3 lines, then print (triple spacing) 
X'4E' + Suppress spacing, then print (overstrike previous line) 
X'F1' 1 Print the data at line position defined as Channel 1 (by 


convention, the first line on a new page) 


X'F2' 2 Print the data at the line position defined as Channel 2 
X'F3' 3 Print the data at the line position defined as Channel 3 
X'F4' 4 Print the data at the line position defined as Channel 4 
X'F5' 5 Print the data at the line position defined as Channel 5 
X'F6' 6 Print the data at the line position defined as Channel 6 
X'F7' 7 Print the data at the line position defined as Channel 7 
X'F8' 8 Print the data at the line position defined as Channel 8 
X'F9' 9 Print the data at the line position defined as Channel 9 
X'C1' A Print the data at the line position defined as Channel 10 
X'C2' B Print the data at the line position defined as Channel 11 
X'C3' Cc Print the data at the line position defined as Channel 12 
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Table 23. ANSI Carriage Control Characters (continued) 


Hexadecimal Value Character Function 


Note: When ANSI carriage controls are used, only the values that appear in this table are considered valid by 
PSF/400. PSF/400 treats any other ANSI carriage control value as invalid and prints any data on the line using single 
spacing. 


Machine Carriage Control Characters 
Table 24. Machine Code Control Characters 


Control Character Value 
(in hexadecimal) Function 
X'03' No operation 
X'09' Print and space 1 line (single spacing) 
X'11' Print and space 2 lines (double spacing) 
X'19' Print and space 3 lines (triple spacing) 
Xx'01' Print without spacing (overstrike next line) 
X'89' Print the data, then skip to the line position defined as Channel 1 (by convention, the 
first line on a new page) 
x'91' Print the data, then skip to the line position defined as Channel 2 
x'99' Print the data, then skip to the line position defined as Channel 3 
X'Al' Print the data, then skip to the line position defined as Channel 4 
X'AQ' Print the data, then skip to the line position defined as Channel 5 
X'B1' Print the data, then skip to the line position defined as Channel 6 
X'B9' Print the data, then skip to the line position defined as Channel 7 
X'C1' Print the data, then skip to the line position defined as Channel 8 
X'Cg' Print the data, then skip to the line position defined as Channel 9 
X'D1' Print the data, then skip to the line position defined as Channel 10 
X'D9' Print the data, then skip to the line position defined as Channel 11 
X'E1' Print the data, then skip to the line position defined as Channel 12 
X'0B' Space 1 line without printing 
X'13' Space 2 lines without printing 
X'1B' Space 3 lines without printing 
X'8B' Skip to Channel 1 immediate (by convention, the first line on a new page) 
X'93' Skip to the Channel 2 position immediate 
X'9B' Skip to the Channel 3 position immediate 
X'A3' Skip to the Channel 4 position immediate 
X'AB' Skip to the Channel 5 position immediate 
X'B3' Skip to the Channel 6 position immediate 
X'BB' Skip to the Channel 7 position immediate 
X'C3' Skip to the Channel 8 position immediate 
X'CB' Skip to the Channel 9 position immediate 
X'D3' Skip to the Channel 10 position immediate 
X'DB' Skip to the Channel 11 position immediate 
X'E3' Skip to the Channel 12 position immediate 
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Table 24. Machine Code Control Characters (continued) 


Control Character Value 
(in hexadecimal) Function 


Note: PSF/400 ignores the following hexadecimal machine-code carriage control characters and does not print lines 
containing them: X'02' through X'07', X'0A’, X'12', X'23', X'43', X'63', X'6B', X'73', X'7B', X'EB', X'F3', and X'FB'. 


PSF/400 treats any other carriage control value as invalid and prints any data on the line using single spacing. 


Table Reference Characters (TRC) 


Table Reference Characters (TRCs) allow an additional byte to appear at the beginning of a line to 
indicate which one of up to four different character arrangement tables (coded fonts specified by 
AFPCHARS parameter) will be used to print the line. This byte, the table reference character contains a 
value of X'FO'", X'F1', X'F2', or X'F3', corresponding to the relative position of the desired coded font in the 
list of coded fonts specified by the AFPCHARS parameter. If carriage control bytes are used with the data, 
the table reference character follows the carriage control byte but precedes the data bytes. If a carriage 
control bytes are not used, the table reference character is the first byte of the data record. As with 
carriage control, if table reference characters are used, every data record must contain a TRC byte. 


Figure 123]summarizes the valid forms of line data. 


Note: The TRC is used for traditional (not record formatting) processing only. 


DATA 


A. Simple data line 


CC DATA 


B. Data line with carriage control byte 


TRC DATA 


C. Data line with table reference character 


cc TRC DATA 


D. Data line with carriage control byte and table reference character 
Figure 123. Valid Line Data Records 


IGC Parameters 
The IGC (Ideo Graphic Characters) parameters of an OS/400 printer file are described here. 


IGCDTA Indicates double byte character set (DBCS) data may be used in the file. The user for a 
line or mixed data file will need to indicate that there is SO/SI present in the data by 
setting IGCDTA to *YES. 


IGCCPI For AFP printers, this parameter is ignored, as the pitch of the DBCS data is determined 
by the selected font. 


For non-AFP printers, when line data is transformed to SCS, this parameter is used to 
specify the pitch of the DBCS data. DBCS SO/SI can not be transformed when going to 
an IPDS printer. 


Mixed data can not be transformed when going to a SCS or IPDS printer. 
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IGCSOSI This keyword indicates what action should be taken when SO/SI are found in the data. If 
the data is mixed, the SO/SI should be taken out and appropriate spaces inserted based 
on the value of this keyword. 


*YES The SO/SI characters will be printed as blanks. 


*NO The system does not print the shift control characters. These characters 
do not occupy a position on the printed output. 


*RIGHT The system prints two blanks when printing the shift-in characters but 
does not print shift-out characters. 


IGCEXNCHR Ignored, as extension character processing only applies to SCS DBCS printer, not AFP 
attached printers. 


IGCCHRRTT For AFP printers, this parameter is ignored. Character rotation can be specified in the 
PAGDFN. 


For non-AFP printers, when line data is transformed to SCS, this parameter is used to 
rotate the DBCS data. 


INVMMAP (Medium-Map-Name) DDS Keyword 


INVMMAP is a record level keyword in DDS used to invoke a medium map. Invoke Medium Map (IMM) 
specifies the name of a medium map in a form definition. Use the IMM in the form definition to select or 
change print parameters such as input drawer, page rotation, overlays. 


The medium map name is limited to 8 characters. You can specify the medium map name as a constant 
or a program-to-system field. 

* medium-map-name 

° field1 


The INVMMAP keyword is valid only with DEVTYPE(*AFPDS). Also, a form definition must be specified on 
the print file. If DEVTYPE is changed to anything other than *AFPDS, the INVMMAP keyword is ignored 
and a warning message will be issued at print time. 


PSF/400 ends printing on the current sheet when a invoke medium map is encountered. 


INVMMAP, SKIP, and SPACE keywords are processed in the following order: 
¢ SKIPB 

* SPACEB 

¢ INVMMAP 

¢ SPACEA 

¢ SKIPA 


The medium map specified remains in effect for the rest of the file unless changed by another INVMMAP 
keyword. 


The invoke medium map keyword is validated at print time. An error message will be issued if it is not 
valid. 


Option indicators are valid for the INVMMAP keyword. 


Figure 124 on page 385) shows how to specify the INVMMAP keyword. 
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0 1 2 3 4 5 6 7 8 
12345678901234567890123456789012345678901234567890123456789012345678901234567890 


* 


R RECORD1 
02 INVMMAP (MAP1) 
R RECORD2 INVMMAP (&MAP) 
MAP BA P 


* 


Figure 124. Specifying the INVMMAP keyword 


If indicator 02 is on, RECORD1 uses a new medium map (MAP1). 


RECORD2 allows the application program to specify the name of medium map by setting program variable 
MAP. 


INVDTAMAP (invoke data map) keyword 


INVDTAMAP is a record-level keyword used to invoke a new data map. It specifies the name of the data 
map in a page definition. The page definition is then used to map the line data. Data maps in page 
definitions can perform functions such as including multiple-up or rotated printing, changing fonts, and lines 
per inch. You must have PSF/400 installed in order to use this keyword. 


The format of the keyword is: 
INVDTAMAP{data-map-name | &data-map-name-field} 


The data-map-name parameter is required and defines a data map in the page definition. This parameter 
is 8 characters in length. The data map name can either be specified as a constant or a 
program-to-system field. 


This keyword is valid with DEVTYPE(*LINE) or DEVTYPE(*AFPDSLINE). A page definition must be 
specified on the print file. If DEVTYPE is changed to anything other than *LINE or *AFPDSLINE, the 
keyword will be ignored and a warning message will be issued at print time. 


The INVDTAMAP, SKIP, and SPACE keywords are processed in the following order: 
* SKIPB 

* SPACEB 

* INVDTAMAP 

* SPACEA 

¢ SKIPA 


The following example shows how to specify the INVDTAMAP keyword: 


0 1 2 3 4 5 6 7 8 
12345678901234567890123456789012345678901234567890123456789012345678901234567890 


* 


R RECORD1 
02 INDTAMAP (MAP1) 
R RECORD2 INDTAMAP (&MAP) ; 
MAP 8A P 


* 


Restrictions When Using PAGDFN and FORMDF 


Device type *LINE or *AFPDSLINE and SPOOL(*NO) will not be allowed on the CRTPRTF or CHGPRTF 
commands. If this condition exists, Message CPD7341, indicating the value SPOOL(*NO) is not valid with 
device type, will be issued. 
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Today when native application output is printed, an inline FORMDF is generated by the OS/400 which 
utilizes the printer file parameters for drawer, duplex, outbin, etc. When users specify a form definition on 
their printer file, this will no longer be done. The form definition will be used for all media handling and the 
printer file parameters for this information will be ignored. The first media map in the FORMDF will be 
used unless the data itself calls out a different media map (such as with the new DDS keyword). 


Native applications which write normal control list-type data (such as RPG and COBOL applications) 
without utilizing the CTLCHAR parameter of the printer file, will generate *MACHINE control character line 
data. There will be no support for generating ANSI control character line data except by the application 
actually writing that type of data using CTLCHAR(*FCFC). 


CVTPPFASRC Command 


The CVTPPFASRC command creates a data base file member from the information contained in the 
library and file containing the PPFA source. The PPFA source file determines the name of the output data 
base file members that is used as input to the CRTFORMDF or CRTPAGDFN command. 

If you want to create an object of type *FORMDF, use the CRTFORMDF command. 

If you want to create an object of type *PAGDFN, use the CRTPAGDFN command. 


Notes: 
1. Form definitions and page definitions are limited to AFP printing with PSF/400. 


2. Those interested in generating page and form definitions for use with the CRTAFPDTA command (this 
command is part of Infoprint Server/400) should refer to the Infoprint Server for OS/400: User’s Guide. 


Syntax 
OS/400 is path-dependent; therefore, sequence and completeness of syntax is very important. The 


CVTPPFASRC command has two required parameters (FILE and MBR) and four subcommands 
(FORMDFFILE, PAGDFNFILE, OUTPUT, and OPTION). 


CVTPPFASRC 
FILE (*LIBL / input-PPFA-source-file-name 
| *CURLIB 7 input-PPFA-source-file-name 
| library-name / input-PPFA-source-file-name) 


MBR ( input-member -name ) 


[FORMDFFILE (*NONE 

*LIBL / form-definition-file 

*CURLIB / form-definition-file 

| library-name / form-definition-file ) ] 


[PAGEDFFILE (*NONE 

*LIBL / page-definition-file 

*CURLIB / page-definition-file 

| library-name / page-definition-file ) ] 


[OUTPUT (*PRINT 
| *NONE ) J 


[OPTION ( { *SRC | *NOSRC } 
{ *SECLVL | *NOSECLVL } ) ] 


Figure 125. Specifying the CVTPPFASRC command 


Note: *NONE may be specified for either FORMDFFILE or PAGDFNFILE, but not for both. 


386  PPFA User's Guide 


Subcommands and Parameters 


The Convert PPFA Source (CVTPPFASRC) command creates a data base file member from the 
information contained in the PPFA source file. The data base file member can then be used either as input 
to the CRTFORMDF command to create an object of type *FORMDF or as input to the CRTPAGDFN 
command to create an object of type *PAGDFN. 


The following parameters are required: 


FILE 


MBR 


Specifies the location of the PPFA source file and library. The possible library values are: 


*LIBL Specifies the PPFA source file is in the library list. 

*CURLIB Specifies the current library for the job is searched. If no library is 
specified as the current library for the job, the QGPL library is used for 
PPFA source. 


library name — Specifies the PPFA source file is in a specific library 
file name File name of the PPFA source file 
Specifies the PPFA source file member. 


member name Specifies the PPFA source member. 


The following parameters are optional: 


FORMDEFILE Specifies the output target file and library to which the compiled form definition member is 


PAGDFNFILE 


placed. This is a flat file, and not yet an OS/400 object. 


The member name is the characters “F1” followed by the FORMDEF name as coded on 
the FORMDEF command in the PPFA source member. This output member must then be 
run as input to the CRTFORMDF command in order to create the form definition object. 
This becomes the OS/400 object. 


*LIBL The PPFA form definition output file is in the library list. 


*CURLIB The current library for the job is searched. If no library is specified as the 
current library for the job, the QGPL library is used for PPFA form 
definition output. 


*FILE The PPFA form definition output is the same as the source file. 
library name — The PPFA form definition output is to go to a specific library. 
file name The file name in which to place the form definition output of the PPFA. 


Specifies the output target file and library to which the compiled page definition member is 
placed. This is a flat file, and not yet an OS/400 object. 


The member name is the characters “P1” followed by the PAGEDEF name as coded on 

the PAGEDEF command in the PPFA source member. This output member must then be 
run as input to the CRTPAGDEN command in order to create a page definition object of 

type *PAGDFN. This becomes the OS/400 object. 


*LIBL The PPFA page definition output file is in the library list. 


*CURLIB The current library for the job is searched. If no library is specified as the 
current library for the job, the QGPL library is used for PPFA page 
definition output. 


*FILE The PPFA page definition output is the same as the source file. 
library name The PPFA page definition output is to go to a specific library. 


file name The file name in which to place the page definition output of the PPFA. 


Appendix A. System Dependencies for PPFA 9387 


OUTPUT Specifies the destination of the listing file and error messages that PPFA produces during 


compilation. 

*PRINT The listing file is sent to the system queue for printing. 

*NONE The listing file is not generated. 

OPTION Specifies the type of output produced when the file is created. 

*SRC A printout of the source statements, including a list of errors is created. 

*NOSRC No printout of the source statements is created unless errors are detected. 
If errors are detected, they are listed along with the sequence number that 
caused the error. 

*SECLVL The online help information appears in the PPFA printout. 


*NOSECLVL The messages section of the PPFA printout does not contain the online 
help information for messages issued during PPFA processing. 


Windows NT and Windows 2000 Environment 


The ppfa command creates form definitions and page definitions on the NT operating system. After they 
are created, you can transfer the form definitions and page definitions to other operating systems (such as 
OS/390, VM, or VSE) to use as AFP resources. 


Syntax 
ppfa [ -fpath.ext | [ -ppath.ext | [ -spath.ext ] [ -x ] inputfile 


Flags and Values 
You can specify these flags and values with the ppfa command. 
inputtile 
The file containing the PPFA source statements to be “processed”. 


-fpath.ext 
Add path and extension information to the names of form definitions generated by PPFA. (The 
name itself comes from the FORMDEF command.) 


-ppath.ext 
Add path and extension information to the names of page definitions generated by PPFA. (The 
name itself comes from the PAGEDEF command.) 


-spath.ext 
Add path and extension information to the listing file. The name of the listing file is the same as 
the name of the input file. 


Thus, for “FORMDEF name” when PPFA was invoked with: 


ppfa -fpath.ext infile it generates form definition: 
\path\F1NAME. ext 


Also, for “FORMDEF name” when PPFA was invoked with: 
ppfa -p\root\abc\def.xyz.nnn infile 


it generates page definition: 
\root\abc\def.xyz\PINAME.nnn 


In another example, if you enter: 
ppfa -pabc\def.xyz input. file 
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and it has a PAGEDEF statement in the source, then the page definition created is either: 
abc\def\P1NAME. xyz 


or 
.\abc\def\PINAME. xyz 


However, if you enter: 
ppfa -p\abc\def.xyz input. file 


PPFA generates the file: 
\abc\def\P1NAME. xyz 


not 


. \abc\def\PINAME. xyz 


-X Causes ppfa to interpret information found in columns 1-72 of the inpuitfile. The information in the 
rest of the columns is ignored. This is useful if you are downloading a Fixed-80 file from the host. 
Examples 
1. To create a form definition from an input file called johnb in the current library containing the PPFA 
source statements, enter: 
ppfa johnb 
The generated form definition is stored in the current library. 
2. To create a form definition from an input file called maryce containing the PPFA source statements, and 


then storing the generated form definition in the /usr/Ipp/resources library, enter: 
ppfa -f\usr\lpp\resources maryc 
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Appendix B. More about Direction 


In PPFA, directions specified with the PRINTLINE and TRCREF commands are relative to the direction 
specified in the PAGEFORMAT command. If no PAGEFORMAT command has been specified, the 
direction specified in the PAGEDEF command is used. If no direction has been specified in either of these 
commands, the default direction for the page format is ACROSS. 


The PRINTLINE and TRCREF commands add their DIRECTION values to the DIRECTION value specified 
with the PAGEFORMAT command. Thus, you may select a PAGEFORMAT direction and code 
PRINTLINEs and TRCREFs relative to the PAGEFORMAT direction. For more information about the 


PRINTLINE and TRCREF commands, see|Chapter 3, “Using Page Definition Commands for Traditional 
Line Data” on page 35 


For instance, if a page is to be printed in the landscape page presentation on a printer that requires the 
DOWN or UP print direction to generate landscape output, the PAGEFORMAT command can specify 
DOWN as its DIRECTION. Once this direction is established, you can view the page as a landscape page 
and specify the PRINTLINE and the TRCREF commands with the ACROSS direction. Output specified in 
this way prints ACROSS relative to the landscape page, as shown in|Figure 126| 


Figure 126. Printing Across a Landscape Page 


Note that if you specify the DOWN direction for the PRINTLINE or the TRCREF command in this case, the 
output looks like|Figure 127) because the direction of the page format is also DOWN. 


Figure 127. Printing Down a Portrait Page 


Table 25 on page 392) shows the final result when all of the possible combinations of DIRECTION are 


specified. The final direction that PPFA computes from the PAGEFORMAT, PRINTLINE, and TRCREF 
commands determines the prefix assigned to the font names specified in the page definition. The final 
direction is particularly important when printing on the 3800 printer because its unbounded-box font 
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architecture requires a separate font for each combination of print direction and character rotation. This 
information is encoded in the prefix of the font name (X1, X38, XA, and XF, for example). 


Table 25. The Effect of Additive DIRECTIONs on Formatting and Font Prefixes 


Page Format PRINTLINE or Final Result 3800 Font 
TRCREF Prefix 
o° 90° 180° 270° 

Across Across Across x1 X5 x9 XD 
Across Down Down X2 X6 XA XE 
Across Back Back X3 X7 XB XF 
Across Up Up X4 X8 XC XG 
Down Across Down X2 X6 XA XE 
Down Down Back X3 X7 XB XF 
Down Back Up X4 X8 XC XG 
Down Up Across x1 X5 x9 XD 
Back Across Back X3 X7 XB XF 
Back Down Up X4 X8 XC XG 
Back Back Across x1 X5 x9 XD 
Back Up Down X2 X6 XA XE 
Up Across Up x4 X8 XC XG 
Up Down Across x1 X5 x9 XD 
Up Back Down X2 X6 XA XE 
Up Up Back X3 X7 XB XF 


The entries in the Final Result column can be computed using a simple algorithm. If you assume that 
ACROSS is 0, DOWN is 1, BACK is 2, and UP is 3, you can add the direction specifications in the two 
commands, subtracting 4 when the result is 4 or greater, to compute the final direction. 
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Appendix C. Differences in Measurements and REPEATs with 
AFP Utilities 


When repeating a DRAWRULE (OGL), PRINTLINE (PPFA), DRAWGRAPHIC (PPFA), or “Line” (PMF), 
there are differences in the measurements of the repeated lines. For OGL, REPEAT indicates the number 
of repetitions in addition to the first. For DRAWGRAPHIC (PPFA), REPEATT is the same as OGL. 
Therefore, REPEAT yields 2 DRAWRULEs. For PPFA, REPEAT indicates the total number of 
PRINTLINEs. Therefore, REPEAT yields 2 PRINTLINEs. 


Another difference occurs when the line spacing (set by SETUNITS in OGL and PPFA, and by a screen 
item in PMF) results in the distance from one line to the next not being a whole number of pels. Each 
product handles the fractional pel differently. Because the printer cannot print parts of a pel, fractional pels 
cannot be represented at the printer. When line spacing calculations result in a fractional pel per line 
space, the following occurs: 


OGL_ Carries the fractions until they add up to a whole pel, then adds it in. This results in the final spot 
of a repeat being within a pel of where it is expected. Therefore, not all of the spaces between 
rules are even; they can vary by one pel. 


PPFA_ Truncates the fractional pel prior to the repeat. Therefore, the spaces between the lines are even, 
but the total might be shorter than expected. 


PMF Rounds the fractional pel prior to the repeat. Therefore, the spaces between the lines are even, 
but the total might be shorter or longer than expected. If the fractional pel is less than 0.5, it is 
handled the same as PPFA and the line space is shorter. If the fractional pel is greater than or 
equal to 0.5, the line space is longer. 


Use line spacing in all products that result in a whole number of pels. To resolve existing problems, select 
the resource that you don’t want to change, and code the remaining resource without using REPEAT 
because of the way the other products handle the fractional pels. 


For example, if you want to print at 9 lines per inch, and repeat this for 20 lines, the following occurs. 


Starting at zero, and adding 9 lines per inch (converted to pels this is 240/9 = 26.6670), you see the 
results illustrated in|Table 26 on page 394 
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Table 26. Differences in Measurements and REPEATs with AFP Utilities 


Mathematics OGL PPFA PMF 

Repetition | Position | FromLast | Position FromLast | Position | FromLast | Position | FromLast 
0.000 eee 0 + 0 --- 0 --- 
1 26.667 26.667 26 26 26 26 27 27 
2 53.333 26.667 53 27 52 26 54 27 
3 80.000 26.667 80 27 78 26 81 27 
4 106.667 26.667 106 26 104 26 108 27 
5 133.333 26.667 133 27 130 26 135 27 
6 160.000 26.667 160 27 156 26 162 27 
7 186.667 26.667 186 26 182 26 189 27 
213.333 216 27 
i 240.000 243 27 
10 266.667 26.667 266 26 260 26 270 27 
11 293.333 26.667 293 27 286 26 297 27 
12 320.000 26.667 320 27 312 26 324 27 
13 346.667 26.667 346 26 338 26 351 27 
14 373.333 26.667 373 27 364 26 378 27 
15 400.000 26.667 400 27 390 26 405 27 
16 426.667 26.667 426 26 416 26 432 27 
17 453.333 26.667 453 Pag 442 26 459 27 
18 480.000 26.667 480 27 468 26 486 27 
19 506.667 26.667 506 26 494 26 513 27 
20 533.333 26.667 533 27 520 26 540 27 


To resolve differences in how OGL, PPFA, and PMF handle repeated values, one of the following 
approaches may be taken: 


¢ Don not use REPEAT 


or 


* Code units as PEL(s) 


Note that in all of these products (except PPFA), a PEL is 1/240 of an inch. For PPFA, the PEL size 


can be set by the user, but defaults to 1/240 of an inch. 
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Appendix D. More About Bar Code Parameters 


This section contains supplemental information about Bar Code Object Content Architecture (BCOCA) 
specified by the BARCODE subcommand of the FIELD command, and includes the following topics: 
* Bar code data 

¢ MOD parameter 


For more complete information, refer to Data Stream and Object Architectures: Bar Code Object Content 
Architecture Reference (S544-3766). 


Bar Code Data 


The data is specified as a series of single-byte code points from a specific code page. Some symbologies 
limit the valid code points to just the ten numerals (0 through 9), other symbologies allow a richer set of 
code points. The bar code symbol is produced from these code points; the code points are also used, 
along with a particular type style, when producing the HRI. 


[Table 27]lists, for each symbology, the valid code page from which characters are chosen and the type 
style used when printing HRI in terms of an IBM registered CPGID and FGID. More information about 
these values can be found in /BM Advanced Function Presentation Fonts: Font Summary and in IBM 
Advanced Function Presentation: Technical Reference for Code Pages. 


Table 27. Valid Code Pages and Type Styles 


Type Bar Code Symbology EBCDIC-Based FGID 
CPGID 

i] Code 39 (3-of-9 Code), AIM USS-39 500 Device specific 
2 MSI (modified Plessey code) 500 Device specific 
3 UPC/CGPC — Version A 893 3 (OCR-B) 

5 UPC/CGPC — Version E 893 3 (OCR-B) 

6 UPC — Two-digit Supplemental (Periodicals) 893 3 (OCR-B) 

7 UPC — Five-digit Supplemental (Paperbacks) 893 3 (OCR-B) 

8 EAN-8 (includes JAN-short) 893 3 (OCR-B) 

9 EAN-13 (includes JAN-standard) 893 3 (OCR-B) 

10 Industrial 2-of-5 500 Device specific 
11 Matrix 2-of-5 500 Device specific 
12 Interleaved 2-of-5, AIM USS-I 2/5 500 Device specific 
13 Codabar, 2-of-7, AIM USS-Codabar 500 Device specific 
17 Code 128, AIM USS-128 1303 Device specific 
22 EAN Two-digit Supplemental 893 3 (OCR-B) 

23 EAN Five-digit Supplemental 893 3 (OCR-B) 

24 POSTNET 500 None 

26 RM4SCC 500 None 

27 JPOSTAL 500 None 

28 2DMATRIX 5004 None 

29 2DMAXI 5004 None 

30 2DPDF417 5002 None 

31 APOSTAL 500 Device Specific 


© Copyright IBM Corp. 1985, 2002 395 


Table 27. Valid Code Pages and Type Styles (continued) 


Type Bar Code Symbology EBCDIC-Based FGID 
CPGID 


1. These two-dimensional bar codes are assumed to start with the default character encodation equivalent to the 
IBM ASCII code page 819. You may use code points from IBM EBCDIC code page 500 if you also use the PPFA 
bar code parameter E2A which instructs the printer to convert the code points from EBCDIC to ASCII. To change 
to a different character encodation within the data, see the AIM International Symbology Specification — Data 
Matrix or MaxiCode. 

2. The PDF417 two-dimensional bar code is assumed to start with the default character encodation GL10 (an ASCII 
code page that is equivalent to IBM code page 437). You may use code points from IBM EBCDIC code page 500 
if you also use the PPFA bar code parameter E2A which instructs the printer to convert the code points from 
EBCDIC to GL10 ASCII. To change to a different character encodation within the data, see the Uniform 
Symbology Specification — PDF417. 


As shown in|Table 27 on page 395} the font used to print HRI depends on the symbology. Some 


symbologies use OCR-B; others use a device-specific font (usually OCR-A). 


Table 28}lists the valid characters for each symbology and specifies how many characters are allowed for 
a bar code symbol. 


Table 28. Valid Characters and Data Lengths 


Code _ /| Bar Code Type Valid Characters Valid Data Length 
X'01' Code 39 (3-of-9 0123456789 Symbology: unlimited 
Code), AIM USS-39 ABCDEFGHIJKLM BCOCA range: 0 to 50 characters 
NOPQRSTUVWYZ (see note}1 on page 398) 
-.$/+% and the space 
character 
A total of 43 valid characters. 

X'02' MSI (modified 0123456789 3 to 15 characters for Modifier X'01' 
Plessey code) 2 to 14 characters for Modifier X'02' 

1 to 13 characters for all other modifiers 

X'03' UPC/CGPC - 0123456789 11 characters 

Version A 
X'05' UPC/CGPC - 0123456789 10 characters 
Version E 
X'06' UPC - Two-digit 0123456789 2 characters for Modifier X'00' 
Supplemental 13 characters for Modifier X'01' 
(Periodicals) 12 characters for Modifier X'02' 

X'07' UPC - Five-digit 0123456789 5 characters for Modifier X'00' 
Supplemental 16 characters for Modifier X'01' 
(Paperbacks) 15 characters for Modifier X'02' 

X'08' EAN-8 (includes 0123456789 7 characters 

JAN-short) 

X'09' EAN-13 (includes 0123456789 12 characters 
JAN-standard) 

X'0A' Industrial 2-of-5 0123456789 Symbology: unlimited 

BCOCA range: 0 to 50 characters 
(see note}1 on page 398) 
X'0B' Matrix 2-of-5 0123456789 Symbology: unlimited 
BCOCA range: 0 to 50 characters 
(see note}1 on page 398) 
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Table 28. Valid Characters and Data Lengths (continued) 


Code _ | Bar Code Type Valid Characters Valid Data Length 
X'0C' Interleaved 2-of-5, 0123456789 Symbology: unlimited 
AIM USS-I 2/5 BCOCA range: 0 to 50 characters 
(see note}1 on page 398) 
X'0D' Codabar, 2-of-7, 0123456789 Symbology: unlimited 
AIM USS-Codabar -$:/.+ABCD BCOCA range: 0 to 50 characters 
16 characters plus 4 start/stop (see note}1 on page 398) 
characters (ABCD) 
(see note}2 on page 398 
X'11' Code 128, AIM All characters defined in the Symbology: unlimited 
USS-128 Code 128 code page BCOCA range: 0 to 50 characters 
(see note}1 on page 398) 
x'16' EAN Two-digit 0123456789 2 characters for Modifier X'00' 
Supplemental 14 characters for Modifier X'01' 
X'17' EAN Five-digit 0123456789 5 characters for Modifier X'00' 
Supplemental 17 characters for Modifier X'01' 
X'18' POSTNET 0123456789 5 characters for Modifier X'00' 
9 characters for Modifier X'01' 
11 characters for Modifier X'02' 
BCOCA range for Modifier X'03': 0 to 50 characters 
(see note}1 on page 398) 
X'1A' Royal Mail 0123456789 Symbology: unlimited 
(RM4SCC modifier ABCDEFGHIJKLM BCOCA range: _0 to 50 characters 
X'00') See note NOPQRSTUVWYZ (see note}1 on page 398) 
Royal Mail (Dutch 0123456789 Symbology: unlimited 
KIX variation, ABCDEFGHIJKLM BCOCA range: 0 to 50 characters 
modifier X'01') NOPQRSTUVWYZ (see note}1 on page 398) 
abcdefghijklm 
nopqrstuvwxyz 
X'1B' Japan Postal Bar 0123456789 Symbology: 7 or more 
Code (modifier ABCDEFGHIJKLM modifier X'00': 
X'00') NOPQRSTUVWYZ BCOCA range: 7 to 50 characters 
- (hyphen) 
Japan Postal Bar 0123456789 BCOCA range: 23 characters; refer to the modifier 
Code (modifier CC1,CC2,CC3,CC4, X'01' description 
X'01') CC5,CC6,CC7,CC8 
- (hyphen),start,stop 
X'1C' 2DMATRIX Any one byte character or Up to 3116 depending on whether the data is 
binary data character or numeric; see symbology specification. 
X'1D' 2DMAXI Any one byte character Up to 93 alphanumeric characters, or up to 138 
numeric characters per symbol. 
X'1E 2DPDF417 Any one byte character or Up to 1850 text characters, 1720 ASCII numeric 


binary data 


digits, or 1108 bytes of binary data per symbol. 
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Table 28. Valid Characters and Data Lengths (continued) 


Code _ | Bar Code Type Valid Characters Valid Data Length 
X'1F' Australia Post Bar Code - refer to the modifier description to see which characters are valid in specific 
parts of the symbol. 

Modifier X'01' - 0123456789 Symbology: 8 digits 
Standard Customer BCOCA range: 8 digits 

Barcode 

Modifier X'02' - 0123456789 Symbology: 8 - 16 digits 
Customer Barcode BCOCA range: 8 - 16 digits 

2 using Table N 

Modifier X'03' - 0123456789 Symbology: 8 - 13 characters 
Customer Barcode ABCDEFGHIJKLM BCOCA range: 8 - 13 characters 

2 using Table C NOPQRSTUVWYZ 

abcdefghijklm 
nopqrstuvwxyz 
( space ) 
# (number sign ) 

Modifier b X'04'- | 0123456789 for sorting code Symbology: 8 - 24 digits 
Customer Barcode | 0-3 for customer information BCOCA range: 8 - 24 digits 
2 using proprietary 

encoding 

Modifier X'05' - 0123456789 Symbology: 8 - 23 digits 
Customer Barcode BCOCA range: 8 - 23 digits 

3 using Table N 

Modifier X'06' - 0123456789 Symbology: 8 - 18 characters 
Customer Barcode ABCDEFGHIJKLM BCOCA range: 8 - 18 characters 

3 using Table C NOPQRSTUVXYZ 

abcdefghijklm 
nopqrstuvwxyz 
( space ) 
# (number sign ) 

Modifier X'07' - 0123456789 for sorting code Symbology: 8 - 39 digits 
Customer Barcode | 0-3 for customer information BCOCA range: 8 - 39 digits 
3 using proprietary 

encoding 
Modifier X'08' - 0123456789 Symbology: 8 digits 
Reply Paid Barcode BCOCA range: 8 digits 


Notes: 
1. All BCOCA receivers must support at least the BCOCA range. Some receivers support a larger data length. 


2. Some descriptions of Codaba show the characters “T,N,*,E” as stop characters (representing the stop characters 
“A,B,C,D”), but the Codabar symbology actually only allows “A,B,C,D” as start and stop characters. This alternate 
representation (“T,N,*,E”) is used only to distinguish between the start and stop characters when describing a 
Codabar symbol; when coding a BCOCA Codabar symbol, start and stop characters must be represented using 
A, B, C, or D. 

3. The data for the UPC and EAN symbologies is numeric and of a fixed length, but not all numbers of the 
appropriate length are valid. This is because the coding scheme is designed to uniquely identify both a product 
and its manufacturer. The first part of the symbol represents the manufacturer and is defined in the symbology 
specification (not all numbers are valid in this part of the symbol). The second part of the symbol represents a 
unique product identifier code assigned by the manufacturer. Refer to the appropriate symbology specification for 
more details. 


4. See RM4SCC on page for additional information. 
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Table 29. Characters and Code Points used in the BCOCA Symbologies; Excluding Code 128 


Character EBCDIC Code Point 


0 X'FO' 


X'F1' 


X'F2' 


X'F3' 


X'F4' 


X'F5' 


X'F6' 


X'F7' 


X'F8' 
X'F9' 


X'C1' 
X'C2' 


X'C3' 


X'C4' 


X'C5' 


X'C6' 


X'C7' 


ZI/O};}TN| Ms) VIO] WI YF] oOl/@asl/N|oa]a] A] wo]rm] a 


X'C8' 


X'C9' 


X'D1' 


X'D2' 


X'D3' 


X'D4' 


X'DS' 


X'D6' 


X'D7' 


X'D8' 


X'D9' 


X'E2! 


X'E3' 


X'E4' 


X'E5' 


X'E6' 


X'E7' 
X'E8' 


X'E9' 
X'81' 


X'82! 


X'83' 


Q2l/oO;/o/MINIK]X/S/<|/C}]Alwm/ D/O}; vl/O;2Z2z/Zzyr]/Alte 


X'84' 
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Table 29. Characters and Code Points used in the BCOCA Symbologies; Excluding Code 128 (continued) 


Character EBCDIC Code Point 
e X'85' 
f X'86' 
g X'87' 
h X'88' 
X'89' 
j X'91' 
k X'92' 
| X'93' 
m X'94! 
n X'95' 
) x'96' 
p X'97' 
q x'98' 
r X'99' 
Ss X'A2' 
t X'A3' 
u X'A4' 
Vv X'A5' 
Ww X'A6' 
X X'A7' 
y X'A8' 
z X'AQ' 
- (hyphen) X'60' 
# (number sign) X'7B' 
. (period) X'4B' 
$ X'5B' 
/ X'61' 
+ X'4E' 
% X'6C' 
X'7A' 
Space X'40' 


The Code 128 code page (CPGID = 1303) is defined as shown in}Figure 128 on page 401 
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Hex 
DIGITS 
ist 0- 1- 2- 3- | 4- 5- 6- 7- 8- 9- | A- | B- | C- | D- | E- | F- 
2nd] 
N 
-0 NUL | DLE (SP) & = { } \ 0 
SE010000 | SE170000 SP010000 | SM030000 | SP100000 $D150000 | SM110000 | SM140000 | SM070000 | ND100000 
= SOH | DC1 / a j © A J 1 
SE020000 | SE180000 SP120000 LA010000 | LJ010000 | SD190000 LA020000 | LJ020000 ND010000 
eo) STX | DC2) FS | SYN b k s B K i) 2 
SE030000 | SE190000 | SE350000 | SE230000 LB010000 | LK010000 | LS010000 LB020000 | LK020000 | LS020000 | ND020000 
3 ETX | DC3 c 1 t C L T 3 
SE040000 | SE200000 LC010000 | LL010000 | LT010000 LC020000 | LL020000 | LTO20000 | ND030000 
-4 d m u D M U 4 
LD010000 |LM010000 | LU010000 LD020000 | LM020000 | LU020000 | ND040000 
<5 HT LF e n Vv E N V 5 
SE100000 SE110000 LE010000 | LN010000 | LV010000 LE020000 | LN020000 | LV020000 | ND050000 
-6 BS | ETB f ) w F O W 6 
SE090000 | SE240000 LF010000 | LO010000 | LW010000 LF020000 | LO020000 | LW020000 | NDO60000 
7 ESC | EOT x G P x 7 
SE280000 | SE050000 LG010000 | LP010000 | LX010000 LG020000 | LP020000 | LX020000 | ND070000 
-8 CAN h q y H Q Y 8 
SE250000 LH010000 | LQ010000 | LY010000 LH020000 | LQ020000 | LY020000 | ND080000 
-9 EM . i r Zz I R Z 9 
SE260000 $D130000 | LI010000 | LR010000 | LZ010000 LI020000 | LR020000 | LZ020000 | ND090000 
-A ! : [ FN2 | FN3 
SP020000 SP130000 SM060000 SE400000 | SE410000 
-B | VT F , # ] 
SE120000 SP110000 | SCO030000 | SPO80000 | SM010000 SM080000 
-C FF DC4 < * % @ 
SE130000 SE210000 | SA030000 | SM040000 | SM020000 | SM050000 
-D CR GS | ENQ | NAK ( ) _ : 
SE140000 | SE360000 | SE060000 | SE220000 | SPO60000 | SPO70000 | SPO90000 | SP050000 
-E SO RS | ACK + ; > = FN4 
SE150000 | SE370000 | SEO70000 SA010000 | SP140000 | SA050000 | SA040000 SE420000 
-F Sl US | BEL | SUB | ? . FN1 DEL 
SE160000 | SE380000 | SE080000 | SE270000 | SO130000 SP150000 | SP040000 | SE390000 SE330000 


Figure 128. Code 128 Code Page (CPGID = 1303) 


Note: All START, STOP, SHIFT, and CODE characters are generated by the printer to produce the 
shortest bar code possible from the given data; these characters are not specified in the Bar Code 
Symbol Data. All code points not listed in the table are undefined. The code points that do not have 
graphic characters shapes, such as X'00' (NUL) and X'8F' (FN1), are control codes defined within 
the Code 128 symbology; in the HRI, control codes print in a device-dependent manner. 


MOD Parameter 


The modifier field gives additional processing information about the bar code symbol to be generated. For 
example, it indicates whether a check-digit is to be generated for the bar code symbol. 
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Table 30}/shows the modifier values for each bar code type. 
Table 30. Modifier Values by Bar Code Type 


Bar Code Type MOD Value 
1 -— Code 39 (3-of-9 Code), AIM USS-39 X'01' and X'02' 
2 — MSI (modified Plessey code) X'01' through X'09' 
3 — UPC/CGPC Version A X'00' 
5 — UPC/CGPC Version E X'00' 
6 — UPC - Two-digit Supplemental X'00' - X'02' 
7 — UPC - Five-digit Supplemental X'00' - X'02' 
8 — EAN 8 (includes JAN-short) X'00' 
9 — EAN 183 (includes JAN-standard) X'00' 
10 — Industrial 2-of-5 X'01' and X'02' 
11 -— Matrix 2-of-5 X'01' and X'02' 
12 — Interleaved 2-of-5, AIM USS-I 2/5 X'01' and X'02' 
13 — Codabar, 2-of-7, AIM USS-Codabar X'01' and X'02' 
17 — Code 128, AIM USS-128 X'02' 
22 — EAN Two-digit Supplemental X'00' and X'01' 
23 — EAN Five-digit Supplemental X'00' and X'01' 
24 — POSTNET X'00' through X'03' 
26 — RM4SCC X'00' and X'01' 
27 — JPOSTAL X'00' and X'01' 
28 — DataMatrix two-dimensional Bar Code X'00' 
29 — MaxiCode two-dimensional Bar Code X'00' 
30 —PDF417 two-dimensional Bar Code X'00' and X'01' 
31 — APOSTAL X'01' - X'08' 


The modifier values, by bar code type, are as follows: 
Code 39 (3-of-9 Code), AIM USS-39 
X'01' Present the bar code without a generated check digit. 


X'02' Generate a check digit and present it with the bar code. 


Note: The Code 39 character set contains 43 characters including numbers, upper-case 
alphabetics, and some special characters. The Code 39 Specification also provides a 
method of encoding all 128 ASCII characters by using 2 bar code characters for those 
ASCII characters that are not in the standard Code 39 character set. This is sometimes 
referred to as “Extended Code 39” and is supported by all BCOCA receivers. In this case, 
the 2 bar code characters used to specify the “extended character” is shown in the 
Human-Readable Interpretation and the bar code scanner interprets the 2-character 
combination bar/space pattern appropriately. 


MSI (modified Plessey code) 
X'01' Present the bar code without check digits generated by the printer. 


X'02' Present the bar code with a generated IBM modulo-10 check digit. This check digit is the 
second check digit; the first check digit is the last character of the data as defined in the 
associated FIELD START and LENGTH subcommands. 
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X'03' 


X'04' 


X'05' 


X'06' 


X'07' 


X'08' 


X'09' 


Present the bar code with two check digits. Both check digits are generated using the IBM 
modulo-10 algorithm. 


Present the bar code with two check digits. The first check digit is generated using the 
NCR modulo-11 algorithm; the second using the IBM modulo-10 algorithm. The first check 
digit equals the remainder; exception condition EC-OE00 exists if the first check-digit 
calculation results in a value of 10. 


Present the bar code with two check digits. The first check digit is generated using the 
IBM modulo-11 algorithm; the second using the IBM modulo-10 algorithm. The first check 
digit equals the remainder; exception condition EC-OE00 exists if the first check-digit 
calculation results in a value of 10. 


Present the bar code with two check digits. The first check digit is generated using the 
NCR modulo-11 algorithm; the second using the IBM modulo-10 algorithm. The first check 
digit equals 11 minus the remainder; a first check digit value of 10 is assigned the value 
zero. 


Present the bar code with two check digits. The first check digit is generated using the 
IBM modulo-11 algorithm; the second using the IBM modulo-10 algorithm. The first check 
digit equals 11 minus the remainder; a first check digit value of 10 is assigned the value 
zero. 


Present the bar code with two check digits. The first check digit is generated using the 
NCR modulo-11 algorithm; the second using the IBM modulo-10 algorithm. The first check 
digit equals 11 minus the remainder; exception condition EC-OE00 exists if the first 
check-digit calculation results in a value of 10. 


Present the bar code with two check digits. The first check digit is generated using the 
IBM modulo-11 algorithm; the second using the IBM modulo-10 algorithm. The first check 
digit equals 11 minus the remainder; exception condition EC-OE00 exists if the first 
check-digit calculation results in a value of 10. 


UPC/CGPC—Version A 


X'00' 


Present the standard UPC-A bar code with a generated check digit. The data to be 
encoded consists of eleven digits. The first digit is the number-system digit; the next ten 
digits are the article number. 


UPC/CGPC—Version E 


X'00' 


Present a UPC-E bar code symbol. Of the 10 input digits, six digits are encoded. The 
check digit is generated using all 10 input data digits. The check digit is not encoded; it is 
only used to assign odd or even parity to the six encoded digits. 


UPC—Two-Digit Supplemental 


X'00' 


X'01' 


X'02' 


Present a UPC two-digit supplemental bar code symbol. This option assumes that the 
base UPC Version A or E symbol is presented as a separate bar code object. The bar and 
space patterns used for the two supplemental digits are left-odd or left-even parity, with 
the parity determined by the digit combination. 


The two-digit UPC supplemental bar code symbol is preceded by a UPC Version A, 
Number System 0, bar code symbol. The bar code object contains both the UPC Version 
A symbol and the two-digit supplemental symbol. The input data consists of the number 
system digit, the ten-digit article number, and the two supplement digits, in that order. A 
check digit is generated for the UPC Version A symbol. The two-digit supplemental bar 
code is presented after the UPC Version A symbol using left-hand odd and even parity as 
determined by the two supplemental digits. 


The two-digit UPC supplemental bar code symbol is preceded by a UPC Version E 
symbol. The bar code object contains both the UPC Version E symbol and the two-digit 
supplemental symbol. The input data consists of the ten-digit article number and the two 
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supplemental digits. The bar code object processor generates the six-digit UPC Version E 
symbol and a check digit. The check digit is used to determine the parity pattern of the 

six-digit Version E symbol. The two-digit supplemental bar code symbol is presented after 
the Version E symbol using left-hand odd and even parity as determined by the two digits. 


UPC—Five-Digit Supplemental 


X'00' Present the UPC five-digit supplemental bar code symbol. This option assumes that the 
base UPC Version A or E symbol is presented as a separate bar code object. A check digit 
is generated from the five supplemental digits and is used to assign the left-odd and 
left-even parity of the five-digit supplemental bar code. The supplemental check digit is not 
encoded or interpreted. 


X'01' ‘The five-digit UPC supplemental bar code symbol is preceded by a UPC Version A, 
Number System 0, bar code symbol. The bar code object contains both the UPC Version 
A symbol and the five-digit supplemental symbol. The input data consists of the number 
system digit, the ten-digit article number, and the five supplement digits, in that order. A 
check digit is generated for the UPC Version A symbol. A second check digit is generated 
from the five supplement digits. It is used to assign the left-hand odd and even parity of 
the five-digit supplemental bar code symbol. The supplement check digit is not encoded or 
interpreted. 


X'02' ‘The five-digit UPC supplemental bar code symbol is preceded by a UPC Version E 
symbol. The bar code object contains both the UPC Version E symbol and the five-digit 
supplemental symbol. The input data consists of the ten-digit article number and the 
five-digit supplemental data. The bar code object processor generates the six-digit UPC 
Version E symbol and check digit. The check digit is used to determine the parity pattern 
of the Version E symbol. The five-digit supplemental bar code symbol is presented after 
the Version E symbol. A second check digit is calculated for the five-digit supplemental 
data and is used to assign the left-hand odd and even parity. The supplement check digit 
is not encoded or interpreted. 


EAN-8 (includes JAN-short) 


X'00' Present an EAN-8 bar code symbol. The input data consists of seven digits: two flag digits 
and five article number digits. All seven digits are encoded along with a generated check 
digit. 

EAN-13 (includes JAN-standard) 


X'00' Present an EAN-13 bar code symbol. The input data consists of twelve digits: two flag 
digits and ten article number digits, in that order. The first flag digit is not encoded. The 
second flag digit, the article number digits, and generated check digit are encoded. The 
first flag digit is presented in HRI form at the bottom of the left quiet zone. The first flag 
digit governs the A and B number-set pattern of the bar and space coding of the six digits 
to the left of the symbol center pattern. 


Industrial 2-of-5 
X'01' Present the bar code without a generated check digit. 
X'02' Generate a check digit and present it with the bar code. 
Matrix 2-of-5 
X'01' Present the bar code symbol without a generated check digit. 
X'02' Generate a check digit and present it with the bar code. 


Interleaved 2-of-5, AIM USS-I 2/5 
The Interleaved 2-of-5 symbology requires an even number of digits. The printer adds a leading 
zero if necessary in order to meet this requirement. 


X'01' Present the bar code symbol without a check digit. 
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X'02' 


Generate a check digit and present it with the bar code. 


Codabar, 2-of-7, AIM USS-Codabar 


X'01' 


X'02' 


Present the bar code without a generated check digit. The input data consists of a start 
character, digits to be encoded, and a stop character, in that order. 


Generate a check digit and present it with the bar code. The input data consists of a start 
character, digits to be encoded, and a stop character, in that order. 


Code 128, AIM USS-128 


X'02' 


Note: 


Generate a check digit and present it with the bar code. 


UCC/EAN 128 is a subset of Code 128 that begins with an FN1 character, followed by an 
Application Identifier and the data to be bar encoded. All of these characters (including the 
FN1 character) must be supplied within the Bar Code Symbol Data (BSA). 


UCC/EAN 128 also requires that the symbol begins in subset C (that is start with a “start 
(Code C)” character), but the original Code 128 symbology specification required the 
symbol to begin in subset B (this is described in Appendix G of the symbology 
specification). Some bar code scanners can handle either start character for an UCC/EAN 
128 symbol, but others require the “start (Code C)” character. Some older IPDS printers 
follow the original Code 128 specification and therefore starts all UCC/EAN 128 symbols 
with a “start (Code B)” character. 


EAN Two-Digit Supplemental 


X'00' 


X'01' 


Present the EAN two-digit supplemental bar code symbol. This option assumes that the 
base EAN-13 symbol is presented as a separate bar code object. The value of the two 
digit supplemental data determines their bar and space patterns chosen from number sets 
A and B. 


The two-digit supplemental bar code symbol is preceded by a normal EAN-13 bar code 
symbol. The bar code object contains both the EAN-13 symbol and the two-digit 
supplemental symbol. The two-digit supplemental bar code is presented after the EAN-13 
symbol using left hand odd and even parity as determined by the two supplemental digits 
chosen from number sets A and B. 


Note: Used for both books and paperbacks. 


EAN Five-Digit Supplemental 


X'00' 


X'01' 


POSTNET 


Present the EAN five-digit supplemental bar code. This option assumes that the base 
EAN-13 symbol is presented as a separate bar code object. A check digit is calculated 
from the five supplemental digits. The check digit is also used to assign the bar and space 
patterns from number sets A and B for the five supplemental digits. The check digit is not 
encoded or interpreted. 


The five-digit supplemental bar code symbol is preceded by a normal EAN-13 bar code 
symbol. The bar code object contains both the EAN-13 symbol and the five-digit 
supplemental symbol. A check digit is generated from the five-digit supplemental data. The 
check digit is used to assign the bar and space patterns from number sets A and B. The 
check digit is not encoded or interpreted. 


Note: Used for books and paperbacks. 


For all POSTNET modifiers that follow, the BSA HRI flag field and the BSD module width, element 
height, height multiplier, and wide-to-narrow ratio fields are not applicable to the POSTNET bar 
code symbology. These fields are ignored because the POSTNET symbology defines specific 
values for these parameters. 
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X'00' 


X'01' 


X'02' 


X'03' 


RM4SCC 
A 4 state customer code defined by the Royal Mail Postal service of England for use in bar coding 
postal code information. 


X'00' 


X'01' 


JPOSTAL 
A complete Japan Postal Bar Code symbol consisting of a set of distinct bars and spaces for each 
character, followed by a modulo 19 checksum character and enclosed by a unique start character, 
stop character, and quiet zones. 
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X'00' 


Present a POSTNET ZIP Code bar code symbol. The ZIP Code to be encoded is defined 
as a five-digit, numeric (0-9), data variable to the BSA data structure. The POSTNET ZIP 
Code bar code consists of a leading frame bar, the encoded ZIP Code data, a correction 

digit, and a trailing frame bar. 


Present a POSTNET ZIP+4 bar code symbol. The ZIP+4 code to be encoded is defined 
as a nine-digit, numeric (0-9), data variable to the BSA data structure. The POSTNET 
ZIP+4 bar code consists of a leading frame bar, the encoded ZIP+4 data, a correction 
digit, and a trailing frame bar. 


Present a POSTNET Advanced Bar Code (ABC) bar code symbol. The ABC code to be 
encoded is defined as an eleven-digit, numeric (0-9), data variable to the BSA data 
structure. The POSTNET ABC bar code consists of a leading frame bar, the encoded ABC 
data, a correction digit, and a trailing frame bar. 


Note: An 11-digit POSTNET bar code is called a Delivery Point bar code. 


Present a POSTNET variable-length bar code symbol. The data to be encoded is defined 
as an n-digit, numeric (0-9), data variable to the BSA data structure. The bar code symbol 
is generated without length checking; the symbol is not guaranteed to be scannable or 
interpretable. The POSTNET variable-length bar code consists of a leading frame bar, the 
encoded data, a correction digit, and a trailing frame bar. 


Present a RM4SCC bar code symbol with a generated start bit, checksum character, and 
stop bit. The start and stop bits identify the beginning and end of the bar code symbol and 
also the orientation of the symbol. 


Present a RM4SCC bar code symbol with no start bar, no checksum character, and no 
stop bar. 


Note: Modifier X'01' is also known as “Dutch Kix Postal Bar Code”. In addition to the 
characters allowed in Modifier X'00', it allows lowercase alphabetical characters 
which are folded to uppercase by the printer. 


Present a Japan Postal Bar Code symbol with a generated start character, checksum 
character, and stop character. 


The generated bar code symbol consists of a start code, a 7-digit new postal code, a 
13-digit address indication number, a check digit, and a stop code. The variable data to be 
encoded (BSA bytes 5-n) is used as follows: 


1. The first few digits represent the new postal code in either the form nnn-nnnn or the 
form nnnnnnn; the hyphen, if present, is ignored and the other 7 digits must be 
numeric. The 7 digits are placed in the new postal code field of the bar code symbol. 


2. If the next digit is a hyphen, it is ignored and is not used in generating the bar code 
symbol. 


3. The remainder of the BSA data is the address indication number, which can contain 
numbers, hyphens, and alphabetic characters (A-Z). Each number and each hyphen 
represents one digit in the bar code symbol; each alphabetic character is represented 
by a combination of a control code (CC1, CC2, or CC3) and a numerical code, and 
handled as two digits in the bar code symbol. Thirteen digits of this address indication 
number data are placed in the address indication number field of the bar code symbol. 
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X'01' 


* If less than 13 additional digits are present, the shortage is filled in with the bar 


code corresponding to control code CC4 up to the thirteenth digit. 


* If more than 13 additional digits are present, the first 13 are used and the remainder 
ignored, with no exception condition reported. However, if the thirteenth digit is the 
control code for an alphabetic (A-Z) character, only the control code is included and 
the numeric part is omitted. 


Present a Japan Postal Bar Code symbol directly from the bar code data. Each valid 
character in the BSA data field is converted into a bar/space pattern, with no validity or 


length checking. The printer does not generate start, stop, or check digits. 


To produce a valid bar code symbol, the bar code data must contain a start code, a 7-digit 
new postal code, a 13-digit address indication number, a valid check digit, and a stop 
code. The new postal code must consist of 7 numeric digits. The address indication 
number must consist of 13 characters, which can be numeric, hyphen, or control 
characters (CC1 through CC8). The following table lists the valid code points for modifier 


X'01': 
Table 31. Valid EBCDIC-based Code Points for Japan Postal Bar Code 
Bar Code Code Point Numerical Bar Code Code Point Numerical 
Character Checking Value Character Checking Value 
start xX'4C' 0 X'FO' 0 
stop X'6E' 1 X'F1' 1 
hyphen X'60' 10 2 X'F2' 2 
CC1 X'5A' 11 3 X'F3' 3 
CC2 X'7F' 12 4 X'F4' 4 
CC3 X'7B' 13 5 X'F5' 5 
CC4 X'E0' 14 6 X'F6' 6 
CC5 X'6C' 15 7 X'F7' 7 
CC6 X'50' 16 8 X'F8' 8 
CC7 X'7D' 17 9 X'FQ' 9 
CC8 X'4D' 18 
Notes: 


1. Do not attempt to use the Start and Stop characters in calculating the check digit. You 
can use the remaining characters to generate check digits; they are the only 
characters that are valid for check digits. Use the Numeric Checking Values to 
calculate the check digits. 


Note: You supply data generation for mod 1. The check digit is the sum of the digits 
modulo 19, which is a remainder of X. The check digit is 19 minus X, converted to 
hex. If this is done incorrectly, the print server displays message ‘APS830I’. 


The hyphen has a hex value of X'60' and a checking digit numerical of 10. 


The following example is a generation of the customer bar code: 


address 
154 


3-16-4, Wakabayshi, Setagaya-ku 


New postal code + address indication number: 


154-0023-3-16-4 
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where, at this point, 154-0023 is the new postal code and 3 - 1 6 - 4 is the address 
indication number. 


Delete hyphens between the third and fourth digits of the new postal code and 
between the new postal code and address indication number, as follows: 


15400233-16-4 


If the address indication number is shorter than 13 digits, use CC4s to fill the 
remaining spaces, as in the following example. 


15400233-16-4 CC4 CC4 CC4 CC4 cc4 CC4 CC4 


The first 7 digits are ignored as the postal code and the remaining digits are the 
address indication number. Remember to count hyphens as digits. In the previous 
example, the postal code is 1540023 and the address indication number is 3 - 1 6 - 
4 plus seven CC4 characters. 


Calculate the check digit (CD), based on the table of correspondence between 
characters for bar code and checking numerals. See|Table 31 on page 407] for more 


information about check digits. 


14+5+44+04+0+24+3+3+10+14+64+104+4+144144+144+144+144144+14+CD = 147 + CD = 
integral multiple of 19. Using the integral multiple of 19, 152 — 147 = 5 for the 
check digit, based on the table of correspondence between characters for bar code 
and checking numerals. Five corresponds to checking numerical five. 


For the previous postal code and address indication number, calculate the hex 
value of the check digit. The following table shows how to convert the data to hex 
values. Add the check digit (CD), start code (STC), and stop code (SPC), as 
follows: 


Table 32. Table Shows How to Convert Data to Hex Values. 


Start Code (STC) 


HEX 


F5 


F4 


FO 


FO 


F2 


F3 


WOl/wW!lnmN;)o;o;fR] oa 


F3 


- 60 


1 F1 


6 F6 


: 60 


4 F4 
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Table 32. Table Shows How to Convert Data to Hex Values. (continued) 


Start Code (STC) HEX 
CC4 EO 
CC4 EO 
CC4 EO 
CD(5) F5 
SPC 6E 


Notice that the check digit (CD) equals 5 and is converted to the hex value of F5. 


The following are examples of various Japanese postal barcodes. 


PAGEDEF SLSRPT; 
PRINTLINE POSITION 2 IN 2 IN; 
FIELD START 1 LENGTH 23 
POSITION CURRENT NEXT 
DIRECTION ACROSS 
BARCODE JAPAN TYPE JPOSTAL MOD 1; 


This barcode used numeric postal codes only. The 7-digit field contains the start, stop, and 
checksum characters. The printer does not generate start, stop, or checksum characters. 
PAGEDEF SLSRPT; 

PRINTLINE POSITION 2 IN 2 IN; 

FIELD START 1 LENGTH 23 

POSITION CURRENT NEXT 

DIRECTION ACROSS 

BARCODE JAPAN TYPE JPOSTAL MOD 1; 


This barcode used alphanumeric postal codes only. The 13-digit field contains start, stop, 
checksum, and command codes. The printer does not generate start, stop, or checksum 
characters. 
PAGEDEF SLSRPT; 

PRINTLINE POSITION 2 IN 2 IN; 

FIELD START 1 LENGTH 7 

POSITION CURRENT NEXT 

DIRECTION ACROSS 

BARCODE JAPAN TYPE JPOSTAL MOD 0; 


This barcode used numeric postal codes only. This is a 7-digit character field. 


PAGEDEF SLSRPT; 
PRINTLINE POSITION 2 IN 2 IN; 
FIELD START 1 LENGTH 13 
POSITION CURRENT NEXT 
DIRECTION ACROSS 
BARCODE JAPAN TYPE JPOSTAL MOD Q; 


This barcode used alphanumeric postal codes only. This is a 13-digit character field. 


2DMATRIX 
A two-dimensional matrix bar code symbology defined as an AIM International Symbology 
Specification — DataMatrix. The bar code data is assumed to start with the default character 
encodation (ECIO00003=ISO 8859-1). This is an international Latin 1 code page that is equivalent 
to the IBM ASCII code page 819. If the EBCDIC to ASCII flag is set (E2A), the data should start 
with encoding equivalent to the IBM EBCDIC code page 500. To change to a different character 
encodation within the data, see the A/M International Symbology Specification — Data Matrix. 


X'00' Present a DataMatrix bar code symbol. 
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Note: For more information about 2DMATRIX two-dimensional matrix bar codes, see|“Data Matrix 
Special-Function Parameters” on page 419 


2DMAXI 

A two-dimensional matrix bar code symbology defined as an AIM International Symbology 

Specification — MaxiCode. The bar code data is assumed to start with the default character 

encodation (ECIO00003=ISO 8859-1). This is an international Latin 1 code page that is equivalent 

to the IBM ASCII code page 819. If the EBCDIC to ASCII flag is set (E2A), the data should start 
with encoding equivalent to the IBM EBCDIC code page 500. To change to a different character 
encodation within the data, see the A/M International Symbology Specification — Data Matrix. 

X'00' Present a MaxiCode bar code symbol. 

Note: For more information about 2DMAXI two-dimensional matrix bar codes, see 

Special-Function Parameters” on page 423 
2DPDF417 

A two-dimensional matrix bar code symbology defined as an AIM International Symbology 

Specification — PDF417. The bar code data is assumed to start with the default character 

encodation (GL10). This is an ASCII code page that is equivalent to the IBM ASCII code page 

437. If the EBCDIC to ASCII flag is set (E2A), the data should start with encoding equivalent to 

the IBM EBCDIC code page 500. To change to a different character encodation within the data, 

see the A/M International Symbology Specification — Data Matrix. 

X'00' Present a full PDF417 bar code symbol. 

X'01' Present a truncated PDF417 bar code symbol for use in an environment in which damage 
to the symbol is unlikely. This version omits the right row indicator and simplifies the stop 
pattern into a single module width bar. 

Note: For more information about 2DPDF417 two-dimensional matrix bar codes, see|“PDF417 

Special-Function Parameters” on page 427 
APOSTAL 

A complete Australian Postal Bar Code symbol consisting of a set of distinct bars and spaces for 

each character. The bar code is set to 8 numeric digits representing the Sorting Code, and can be 

followed by from 0 to 31 numeric digits of Customer Information. 

Australia Post Bar Code 
A bar code symbology defined by Australia Post for use in Australian postal systems. 
There are several formats of this bar code which are identified by the modifier byte as 
follows: 

Modifier Type of bar code Valid bar code data 
X'01' Standard Customer Barcode An 8 digit number representing the Sorting Code 
(format code = 11) 
X'02' Customer Barcode 2 using An 8 digit number representing the Sorting Code followed by 
Table N (format code = 59) up to 8 numeric digits representing the Customer Information 
X'03' Customer Barcode 2 using An 8 digit number representing the Sorting Code followed by 
Table C (format code = 59) up to 5 characters (A-Z, a-z, 0-9, space, #) representing the 
Customer Information 
X'04' Customer Barcode 2 using An 8 digit number representing the Sorting Code followed by 
proprietary encoding (format up to 16 numeric digits (0-3) representing the Customer 
code = 59) Information. Each of the 16 digits specify one of the 4 types of 
bar. 
X'05' Customer Barcode 3 using An 8 digit number representing the Sorting Code followed by 
Table N (format code = 62) up to 15 numeric digits representing the Customer Information 
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X'06' Customer Barcode 3 using An 8 digit number representing the Sorting Code followed by 
Table C (format code = 62) up to 10 characters (A-Z, a-z, 0-9, space, #) representing the 
Customer Information 
X'07' Customer Barcode 3 using An 8 digit number representing the Sorting Code followed by 
proprietary encoding (format up to 31 numeric digits (0-3) representing the Customer 
code = 62) Information. Each of the 31 digits specify one of the 4 types of 
bar. 
X'08' Reply Paid Barcode (format An 8 digit number representing the Sorting Code 
code = 45) 


Check Digit Calculation Method 


The proprietary encoding allows the customer to specify the types of bars to be printed directly by using 0 
for a full bar, 1 for an ascending bar, 2 for a descending bar, and 3 for a timing bar. If the customer does 
not specify enough Customer Information to fill the field, the printer uses a filler bar to extend pad the field 
out to the correct number of bars. 


The printer encodes the data using the proper tables, generate the start and stop bars, generate any 
needed filler bars, and generate the Reed Solomon ECC bars. 


Human readable interpretation (HRI) can be selected with this bar code type. The format control code, 
Delivery Point Identifier, and customer information field (if any) appears in the HRI, but the ECC does not. 


Some bar code types and modifiers call for the calculation and presentation of check digits. Check digits 
are a method of verifying data integrity during the bar coding reading process. Except for UPC Version E, 
the check digit is always presented in the bar code bar and space patterns, but is not always presented in 
the HRI. The following table shows the check digit calculation methods for each bar code type and the 
presence or absence of the check digit in the HRI. 


Table 33. Check Digit Calculation Methods For Each Bar Code 


Bar Code Type Modifier In HRI? Check Digit Calculation 
1 — Code 39 (3-of-9 Code), AIM X'02' Yes Modulo 43 of the sum of the data characters’ 
USS-39 numerical values as described in a Code 39 


specification. The start and stop codes are not 
included in the calculation. 


2 — MSI (modified Plessey X'02' — X'09' No IBM Modulus 10 check digit: 

code) 1. Multiply each digit of the original number by 
a weighting factor of 1 or 2 as follows: 
multiply the units digit by 2, the tens digit by 
1, the hundreds digit by 2, the thousands 
digit by 1, and so forth. 

2. Sum the digits of the products from step 1. 
This is not the same as summing the values 
of the products. 

3. The check digit is described by the following 
equation where “sum” is the resulting value 
of step 2: (10 - (Sum modulo 10)) modulo 10 
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Table 33. Check Digit Calculation Methods For Each Bar Code (continued) 


Bar Code Type 


Modifier 


In HRI? 


Check Digit Calculation 


IBM Modulus 11 check digit: 


1. 


to 


Multiply each digit of the original number by 
a repeating weighting factor pattern of 2, 3, 
4, 5, 6, 7 as follows: multiply the units digit 
by 2, the tens digit by 3, the hundreds digit 
by 4, the thousands digit by 5, and so forth. 
Sum the products from step 1. 

The check digit depends on the bar code 
modifier. The check digit as the remainder is 
described by the following equation where 
“sum” is the resulting value of step 2: (sum 
modulo 11) 


The check digit as 11 minus the remainder 


is described by the following equation: (11 - 
(sum modulo 11)) modulo 11 


NCR Modulus 11 check digit: 


. 


nm 


Multiply each digit of the original number by 
a repeating weighting factor pattern of 2, 3, 
4, 5, 6, 7, 8, 9 as follows: multiply the units 
digit by 2, the tens digit by 3, the hundreds 
digit by 4, the thousands digit by 5, and so 
forth. 

Sum the products from step 1. 

The check digit depends on the bar code 
modifier. The check digit as the remainder is 
described by the following equation where 
“sum” is the resulting value of step 2: (sum 
modulo 11) 


The check digit as 11 minus the remainder 


is described by the following equation: (11 - 
(sum modulo 11)) modulo 11 


3 — UPC/CGPC Version A 


X'00' 


Yes 


UPC/EAN check digit calculation: 


1s 


© 


Multiply each digit of the original number by 
a weighting factor of 1 or 3 as follows: 
multiply the units digit by 3, the tens digit by 
1, the hundreds digit by 3, the thousands 
digit by 1, and so forth. 

Sum the products from step 1. 

The check digit is described by the following 
equation where “sum” is the resulting value 
of step 2: (10 - (Sum modulo 10)) modulo 10 


5 — UPC/CGPC Version E 


X'00' 


Yes 


See UPC/CGPC Version A 


8 — EAN 8 (includes JAN-short) 


X'00' 


Yes 


See UPC/CGPC Version A 


9 — EAN 13 (includes 
JAN-standard) 


X'00' 


Yes 


See UPC/CGPC Version A 


10 — Industrial 2-of-5 


X'02' 


Yes 


See UPC/CGPC Version A 


11 — Matrix 2-of-5 


X'02' 


Yes 


See UPC/CGPC Version A 


12 — Interleaved 2-of-5 


X'02' 


Yes 


See UPC/CGPC Version A 
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Table 33. Check Digit Calculation Methods For Each Bar Code (continued) 


Bar Code Type 


Modifier 


In HRI? 


Check Digit Calculation 


13 — Codabar, 2-of-7, AIM 
USS-Codabar 


X'02' 


No 


Codabar check digit calculation: 

1. Sum of the data characters’ numerical 
values as described in a Codabar 
specification. All data characters are used, 
including the start and stop characters. 

2. The check digit is described by the following 
equation where “sum” is the resulting value 
of step 1: (16 - (Sum modulo 16)) modulo 16 


17 — Code 128, AIM USS-128 


X'02' 


No 


Code 128 check digit calculation: 

1. Going left to right starting at the start 
character, sum the value of the start 
character and the weighted values of data 
and special characters. The weights are 1 
for the first data or special character, 2 for 
the second, 3 for the third, and so forth. The 
stop character is not included in the 
calculation. 

2. The check digit is modulo 103 of the 
resulting value of step 1. 


24 — POSTNET 


X'00' — X'03' 


NA 


The POSTNET check digit is (10 - (Sum modulo 
10)) modulo 10, where “sum” is the sum of the 
ZIP code data. 


26 — RM4SCC 


X'00' 


NA 


The RM4SCC checksum digit is calculated 
using an algorithm that weights each of the 4 
bars within a character in relation to its position 
within the character. 


X'01' 


NA 


None. 


27 — JPOSTAL 27 


X'00' 


N/A 


The Japan Postal Bar Code check digit 
calculation: 


Convert each character in the bar code data 
into decimal numbers. Numeric characters are 
converted to decimal; each hyphen character is 
converted to the number 10, each alphabetic 
character is converted to two numbers 
according to the symbology definition. 


For example, A becomes “11 and 0”, B becomes 
“11 and 1”,..., J becomes “11 and 9”, K 
becomes “12 and 0”, L becomes “12 and 1”, ..., 
T becomes “12 and 9”, U becomes “13 and 0”, 
V becomes “13 and 1”, ..., and Z becomes “13 
and 5”. 


Sum the resulting decimal numbers and 
calculate the remainder modulo 19. 


The check digit is 19 minus the remainder. 


X'01' 


N/A 


None 


28 — 2DMATRIX 


X'00' 


N/A 


None 


29 — 2DMAXI 


X'00' 


N/A 


None 


30 — 2DPDF417 


X'00'—X'01' 


N/A 


None 
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Table 33. Check Digit Calculation Methods For Each Bar Code (continued) 


Bar Code Type Modifier In HRI? Check Digit Calculation 
31 — APOSTAL X'01' — X'08' No The Australian Post Bar Code uses a Reed 
Solomon error correction code based on Galois 
Field 64. 
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Barcode Exception Conditions 


This section lists the BCOCA exception conditions required to be detected by the bar code object 
processor when processing the bar code data structures and specifies the standard actions to be taken. 


Specification-Check Exceptions 


A specification-check exception indicates that the bar code object processor has received a bar code 
request with invalid or unsupported data parameters or values. 


Exception 
EC-0300 


EC-0400 


EC-0500 


EC-0505 


EC-0600 


EC-0605 


EC-0700 


EC-0705 


Description 


The bar code type specified in the BSD data structure is invalid or 
unsupported. 


Standard Action: Terminate bar code object processing. 


A font local ID specified in the BSD data structure is unsupported or not 
available. 


For those symbologies that require a specific type style or code page for 
HRI, the BCOCA receiver cannot determine the type style or code page of 
the specified font. 


Standard Action: If the requested font is not available, a font substitution 
can be made preserving as many characteristics as possible of the 
originally requested font while still preserving the original code page. 
Otherwise, terminate bar code object processing. 


Some bar code symbologies specify a set of type styles to be used for 
HRI data. Font substitution for HRI data must follow the bar code 
symbology specification being used. 


The color specified in the BSD data structure is invalid or unsupported. 
Standard Action: The device default color is used. 


The unit base specified in the BSD data structure is invalid or 
unsupported. 


Standard Action: Terminate bar code object processing. 


The module width specified in the BSD data structure is invalid or 
unsupported. 


Standard Action: The bar code object processor uses the closest smaller 
width. If the smaller value is less than the smallest supported width or 
zero, the bar code object processor uses the smallest supported value. 


The units per unit base specified in the BSD data structure is invalid or 
unsupported. 


Standard Action: Terminate bar code object processing. 


The element height specified in the BSD data structure is invalid or 
unsupported. 


Standard Action: The bar code object processor uses the closest smaller 
height. If the smaller value is less than the smallest supported element 
height or zero, the bar code object processor uses the smallest supported 
value. 


The presentation space extents specified in the BSD data structure are 
invalid or unsupported. 
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EC-0800 


EC-0900 


EC-0A00 


EC-0B00 


EC-0C00 


EC-0E00 


EC-0F00O 


EC-0F01 


EC-0F02 


EC-0F03 


EC-0F04 
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Standard Action: Terminate bar code object processing. 
The height multiplier specified in the BSD data structure is invalid. 
Standard Action: The bar code object processor uses X'01'. 


The wide-to-narrow ratio specified in the BSD data structure is invalid or 
unsupported. 


Standard Action: The bar code object processor uses the default 
wide-to-narrow ratio. The default ratio is in the range of 2.25 through 3.00 
to 1. The MSI bar code, however, uses a default wide-to-narrow ratio of 
2.00 to 1. 


The bar code origin (Xoffset value or Yoffset value) given in the BSA data 
structure is invalid or unsupported. 


Standard Action: Terminate bar code object processing. 


The bar code modifier in the BSD data structure is invalid or unsupported 
for the bar code type specified in the same BSD. 


Standard Action: Terminate bar code object processing. 


The length of the variable data specified in the BSA data structure plus 
any bar code object processor generated check digits is invalid or 
unsupported. 


Standard Action: Terminate bar code object processing. 


The first check-digit calculation resulted in a value of 10; this is defined as 
an exception condition in some of the modifier options for MSI bar codes 
in the BSD data structure. 


Standard Action: Terminate bar code object processing. 


Either the matrix row size value or the number of rows value specified in 
the BSA data structure is unsupported. Both of these values must be 
within the range of supported sizes for the symbology. 


Standard Action: Use X'0000' for the unsupported value so that an 
appropriate size is used based on the amount of symbol data. 


An invalid structured append sequence indicator was specified in the BSA 
data structure. For a Data Matrix symbol, the sequence indicator must be 
between 1 and 16 inclusive. For a MaxiCode symbol, the sequence 
indicator must be between 1 and 8 inclusive. 


Standard Action: Present the bar code symbol without structured append 
information. 


A structured append sequence indicator specified in the BSA data 
structure is larger than the total number of structured append symbols. 


Standard Action: Present the bar code symbol without structured append 
information. 


Mismatched structured append information was specified in the BSA data 
structure. One of the sequence-indicator and total-number-of-symbols 
parameters was X'00', but the other was not X". 


Standard Action: Present the bar code symbol without structured append 
information. 


An invalid number of structured append symbols was specified in the BSA 
data structure. For a Data Matrix symbol, the total number of symbols 


EC-0F05 


EC-OF06 


EC-0F07 


EC-0F08 


EC-0F09 


EC-0FOA 


EC-0FOB 


must be between 2 and 16 inclusive. For a MaxiCode symbol, the total 
number of symbols must be between 2 and 8 inclusive. 


Standard Action: Present the bar code symbol without structured append 
information. 


For a MaxiCode symbol, the symbol mode value specified in the BSA data 
structure is invalid. 


Standard Action: Terminate bar code object processing. 


For a PDF417 symbol, the number of data symbol characters per row 
value specified in the BSA data structure is invalid. 


Standard Action: Terminate bar code object processing. 


For a PDF417 symbol, the desired number of rows value specified in the 
BSA data structure is invalid. 


This exception condition can also occur when the number of rows times 
the number of data symbol characters per row is greater than 928. 


Standard Action: Proceed as if X'FF' was specified. 


For a PDF417 symbol, too much data was specified in the BSA data 
structure. 


Standard Action: Terminate bar code object processing. 


For a PDF417 symbol, the security level value specified in the BSA data 
structure is invalid. 


Standard Action: Proceed as if security level 8 was specified. 


An incompatible combination of Data Matrix parameters was specified in 
the BSA data structure. The following conditions can cause this exception 
condition: 


¢ A structured append was specified (byte 10 not X'00'), but either the 
reader programming flag was set to B'1' or a hdr/trl macro was 
specified. 

* The UCC/EAN FNC1 flag was set to B'1', but either the industry FNC1 
flag was set to B'1', the reader programming flag was set to B'1', ora 
hdr/trl macro was specified. 

* The industry FNC1 flag was set to B'1', but either the UCC/EAN FNC1 
flag was set to B'1', the reader programming flag was set to B'1', ora 
hdr/trl macro was specified. 

* The reader programming flag was set to B'1', but either a structured 
append was specified, one of the FNC1 flags was set to B'1', or a hdr/trl 
macro was specified. 

¢ Ahdr/trl macro was specified, but either a structured append was 
specified, one of the FNC1 flags was set to B'1’, or the reader 
programming flag was set to B'1'. 


Standard Action: Terminate bar code object processing. 


An invalid structured append file identification value was specified in the 
BSA data structure. Each byte of the 2-byte file identification value must 
be in the range X'01'—X'FE'. 


Standard Action: Present the bar code symbol without structured append 
information. 
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EC-0FOC 


EC-0FOD 


EC-1000 


EC-1100 


A Macro PDF417 Control Block length value specified in the BSA data 
structure is invalid. 


Standard Action: Terminate bar code object processing. 


Data within a Macro PDF417 Control Block specified in the BSA data 
structure is invalid. 


Standard Action: Present the bar code symbol without a Macro PDF417 
Control Block. 


The human-readable interpretation location specified in the the BSA data 
structure is invalid. 


Standard Action: Terminate bar code object processing. 

A portion of the bar code, including the bar and space patterns and the 
HRI, extends outside of either: 

* The bar code presentation space 


* The intersection of the mapped bar code presentation space and the 
controlling environment object area 


* The maximum presentation area. 
Standard Action: Terminate bar code object processing. 
All bar code symbols must be presented in their entirety. Whenever a 


partial bar code pattern is presented, for whatever reason, it is obscured 
to make it unscannable. 


Data-Check Exceptions 


A data-check exception indicates that the bar code object processor has detected an undefined character. 


Exception 
EC-2100 
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Description 


An invalid or undefined character, according to the rules of the symbology 
specification, has been detected in the bar code data. 


Standard Action: Terminate bar code object processing. 


Data Matrix Special-Function Parameters 


Offset Type |Name Range Meaning BCD1 
Range 
5 BITS Control flags 
EBCDIC EBCDIC-to-ASCIl translation: Not 
bit O B'0' Do not translate supported 
B'1' Convert data from EBCDIC to ASCII in BCD1 
Escape Escape-sequence handling: Not 
bit 1 sequence B'0' Process escape sequences supported 
handling B'1' Ignore all escape sequences in BCD1 
bits 2—7 B'000000' Reserved 
Desired row | X'0000' No size specified Not 
6-7 UBIN | size X'0001'—X'FFFE' | Matrix row size as allowed by symbology; see supported 
field description in BCD1 
Desired X'0000' No size specified Not 
8-9 UBIN | number of X'0001'—X'FFFE' | Number of rows as allowed by symbology; see supported 
rows field description in BCD1 
Sequence X'00'—X'10' Structured append sequence indicator Not 
10 UBIN | indicator supported 
in BCD1 
Total X'00' or Total number of structured-append symbols Not 
11 UBIN | symbols X'02'—X'10' supported 
in BCD1 
File ID 1st X'01'—X'FE' High-order byte of a 2-byte unique file Not 
12 UBIN | byte identification for a set of structured-append supported 
symbols in BCD1 
File ID 2nd | X'01'—X'FE' Low-order byte of a 2-byte unique file identification | Not 
13 UBIN | byte for a set of structured-append symbols supported 
in BCD1 
14 BITS Special-function flags 
UCC/EAN Alternate data type identifier: Not 
bit O FNC1 B'0' User-defined symbol supported 
B'1' Symbol conforms to UCC/EAN standards in BCD1 
Industry Alternate data type identifier: Not 
bit 1 FNC1 B'0' User-defined symbol supported 
B'1' Symbol conforms to industry standards in BCD1 
Reader Reader programming symbol: Not 
bit 2 programming | B'0' Symbol encodes a data symbol supported 
B'1' Symbol encodes a message used to program in BCD1 
the reader system 
Hdr/Trl Header and trailer instructions to the bar code Not 
Macro reader: supported 
bit 3-4 B'00' No header or trailer in BCD1 
B'01' Use the 05 Macro header/trailer 
B'10' Use the 06 Macro header/trailer 
B'11' No header or trailer 
bit 5—7 B'000' Reserved 


A desired symbol size can be specified in bytes 6&—9, but the actual size of the symbol depends on the 
amount of data to be encoded. If not enough data is supplied, the symbol is padded with null data to reach 
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the requested symbol size. If too much data is supplied for the requested symbol size, the symbol is 
bigger than requested, but the aspect ratio is maintained as closely as possible. 


Byte 5 


Control flags 


These flags control how the bar code data (bytes n+1 to end) is processed by the BCOCA 
receiver. 


Bit 0 EBCDIC-to-ASCII translation 


If this flag is B'O', the data is assumed to begin in the default character encodation and no 
translation is done. 


If this flag is B'1', the BCOCA receiver converts each byte of the bar code data from 
EBCDIC code page 500 into ASCII code page 819 before this data is used to build the bar 
code symbol. 


Bit 1 Escape-sequence handling 


If this flag is B'0'", each X'5C' (backslash) within the bar code data is treated as an escape 
character according to the Data Matrix symbology specification. 


If this flag is B'1', each X'5C' within the bar code data is treated as a normal data 
character and therefore all escape sequences are ignored. In this case, no ECI code page 
switching can occur within the data. 


Note: If the EBCDIC-to-ASCII translation flag is also set to B'1', all EBCDIC backslash 
characters (X'E0’) are first converted into X'5C' before the escape-sequence 
handling flag is applied. 

Bits 2—7 

Reserved 


Bytes 6—7 


Desired row size 


For a Data Matrix symbol, this parameter specifies the desired number of modules in each row 
including the finder pattern. There must be an even number of modules per row and an even 
number of rows. There are square symbols with sizes from 10x10 to 144x144, and rectangular 
symbols with sizes from 8x18 to 16x48 not including quiet zones. The following table lists the 
complete set of supported sizes. Exception condition EC-OFOO exists EC-OFO00 if an unsupported 
size value is specified. 


If X'0000' is specified for this parameter, an appropriate row size is used based on the amount of 
symbol data. 


Table 34. Supported Sizes for a Data Matrix symbol 


Square Symbols Rectangular Symbols 
Symbol Size Data Region Symbol Size Data Region 
NUMBe ret Row size Size Number Numberot Row size Size Number 
rows rows 

10 10 8x8 1 8 18 6x6 1 
12 12 10x10 1 8 32 6x14 2 
14 14 12x12 1 12 26 10x24 1 
16 16 14x14 1 12 36 10x16 2 
18 18 16x16 1 16 36 14x16 2 
20 20 18x18 1 16 48 14x22 2 
22 22 20x20 1 
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Table 34. Supported Sizes for a Data Matrix symbol (continued) 


Square Symbols Rectangular Symbols 

24 24 22x22 1 

26 26 24x24 1 

32 32 14x14 4 
36 36 16x16 4 
40 40 18x18 4 
44 44 20x20 4 
48 48 22x22 4 
52 52 24x24 4 
64 64 14x14 16 
72 72 16x16 16 
80 80 18x18 16 
88 88 20x20 16 
96 96 22x22 16 
104 104 24x24 16 
120 120 18x18 36 
132 132 20x20 36 
144 144 24x24 36 

Bytes 8-9 


Desired number of rows 


For a Data Matrix symbol, this parameter specifies the desired number of rows including the finder 
pattern. Exception condition EC-OFO00 exists if an unsupported size value is specified. 


If X'0000' is specified for this parameter, an appropriate number of rows are used based on the 
amount of symbol data. 


Byte 10 


Structured append sequence indicator 


Multiple data matrix bar code symbols (called structured appends) can be logically linked together 
to encode large amounts of data. The logically linked symbols can be presented on the same or 
on different physical media, and are logically recombined after they are scanned. From 2 to 16 
Data Matrix symbols can be linked. This parameter specifies where this symbol is logically linked 
(1—16) in a sequence of symbols. 


If X'00' is specified for this parameter, this symbol is not part of a structured append. Exception 
condition EC-OF01 exists if an invalid sequence indicator value is specified. Exception condition 
EC-0F02 exists if the sequence indicator is larger than the total number of symbols (byte 11). 


If this field is not X'00', the reader programming flag must be B’0' and the hdr/trl macro flags must 
be either B'00' or B'11'. Exception condition EC-OFOA exists if an incompatible combination of 
these parameters is specified. 


Total symbols in a structured append 


This parameter specifies the total number of symbols (2—16) that is logically linked in a sequence 
of symbols. 
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If X'00' is specified for this parameter, this symbol is not part of a structured append. If this symbol 
is not part of a structured append, both bytes 10 and 11 must be 00 or exception condition 
EC-0F03 exists. 


Exception condition EC-OF04 exists if an invalid number of symbols is specified. 


Byte 12 


High-order byte of structured append file identification 


This parameter specifies the high-order byte of a 2-byte unique file identification for a set of 
structured-append symbols, which helps ensure that the symbols from two different structured 
appends are not linked together. The low-order byte of the 2-byte field is specified in byte 13. 
Each of the two bytes can contain a value in the range X'01'—X'FE’. 


This parameter is ignored if this symbol is not part of a structured append. 


If this symbol is part of a structured append, but byte 12 contains an invalid value (X'00' or X'FF’), 
exception condition EC-OFOB exists. 


Byte 13 


Low-order byte of structured append file identification 


This parameter specifies the low-order byte of a 2-byte unique file identification for a set of 
structured-append symbols. The high-order byte of the 2-byte field is specified in byte 12. Each of 
the two bytes can contain a value in the range X'01'—X'FE'. 


This parameter is ignored if this symbol is not part of a structured append. 


If this symbol is part of a structured append, but byte 13 contains an invalid value (X'00' or X'FF’), 
exception condition EC-OFOB exists. 


Byte 14 
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Special-function flags 
These flags specify special functions that can be used with a Data Matrix symbol. 
BitO0 UCC/EAN FNC1 alternate data type identifier 


If this flag is B'1', an FNC1 shall be added in the first data position (or fifth position of a 
structured append symbol) to indicate that this symbol conforms to the UCC/EAN 
application identifier standard format. In this case, the industry FNC1 flag must be B'0', the 
reader programming flag must be B'0', and the hdr/trl macro must be B'00' or B'11'. 
Exception condition EC-OFOA exists if an incompatible combination of these parameters is 
specified. 


Bit 1 = Industry FNC1 alternate data type identifier 


If this flag is B'1', an FNC1 shall be added in the second data position (or sixth position of 
a structured append symbol) to indicate that this symbol conforms to a particular industry 
standard format. In this case, the UCC/EAN FNC1 flag must be B'0', the reader 
programming flag must be B'0'", and the hdr/trl macro must be B'00' or B'11'. Exception 
condition EC-OFOA exists if an incompatible combination of these parameters is specified. 


Bit 2 Reader programming 


If this flag is B'1', this symbol encodes a message used to program the reader system. In 
this case, the structured append sequence indicator must be X'00', the UCC/EAN FNC1 
and industry FNC1 flags must both be B'0'", and the hdr/trl macro flags must be either B'00' 
or B'11'. Exception condition EC-OFOA exists if an incompatible combination of these 
parameters is specified. 


Bits 3-4 
Header and trailer instructions to the bar code reader 
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This field provides a means of instructing the bar code reader to insert an industry specific 
header and trailer around the symbol data. 


If this field is B'00' or B'11', no header or trailer is inserted. If this field is B'01', the bar 
code symbol contains a 05 Macro codeword. If this field is B'10', the bar code symbol 


contains a 06 Macro codeword. 


If these flags are B'01' or B'10', the structured append sequence indicator must be X'00', 


the UCC/EAN FNC1 and industry FNC1 flags must both be B'0', and the reader 


programming flag must be B'0'. Exception condition EC-OFOA exists if an incompatible 
combination of these parameters is specified. 


Bits 5—7 


Reserved 


MaxiCode Special-Function Parameters 


Offset Type |Name Range Meaning BCD1 
Range 
5 BITS Control flags 
EBCDIC EBCDIC-to-ASCIl translation: Not 
bit O B'0' Do not translate supported 
B'1' Convert data from EBCDIC to ASCII in BCD1 
Escape Escape-sequence handling: Not 
bit 1 sequence B'0' Process escape sequences supported 
handling B'1' Ignore all escape sequences in BCD1 
bits 2—7 B'000000' Reserved 
Symbol x'02' Mode 2 Not 
Mode X'03' Mode 3 supported 
6 CODE Xx'04' Mode 4 in BCD1 
X'05' Mode 5 
X'06' Mode 6 
Sequence X'00'—X'08' Structured append sequence indicator Not 
7 UBIN _ | indicator supported 
in BCD1 
Total X'00' or Total number of structured-append symbols Not 
8 UBIN | symbols X'02'—X'08' supported 
in BCD1 
9 BITS Special-function flags 
Zipper No zipper pattern Not 
bit O B'0' Vertical zipper pattern on right supported 
B'1' in BCD1 
bit 1—7 B'0000000' Reserved 
Byte 5 


Control flags 


These flags control how the bar code data (bytes n+1 to end) is processed by the BCOCA 
receiver. 


Bit 0 EBCDIC-to-ASCII translation 


If this flag is B'O', the data is assumed to begin in the default character encodation and no 
translation is done. 
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Byte 6 
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If this flag is B'1', the BCOCA receiver converts each byte of the bar code data from 
EBCDIC code page 500 into ASCII code page 819 before this data is used to build the bar 
code symbol. 


Bit 1 Escape-sequence handling 

If this flag is B'0'", each X'5C' (backslash) within the bar code data is treated as an escape 

character according to the MaxiCode symbology specification. 

If this flag is B'1', each X'5C' within the bar code data is treated as a normal data 

character and therefore all escape sequences are ignored. In this case, no ECI code page 

switching can occur within the data. 

Note: If the EBCDIC-to-ASCIl translation flag is also set to B'1', all EBCDIC backslash 
characters (X'E0’) are first converted into X'5C' before the escape-sequence 
handling flag is applied. 

Bits 2—7 

Reserved 


Symbol mode 


Mode 2 


Mode 3 


Structured Carrier Message - numeric postal code 


This mode is designed for use in the transport industry, encoding the postal code, country 
code, and service class with the postal code being numeric. The bar code data should be 
structured as described in B.2.1 and B.3.1 of the A/M International Symbology 
Specification - MaxiCode. The postal code, country code, and service class are placed in 
the primary message portion of the MaxiCode symbol and the rest of the bar code data is 
placed in the secondary message portion of the MaxiCode symbol. The first part of the bar 
code data includes the postal code, country code and service class, in that order, 
separated by the [GS] character (X'1D'). This information may be preceded by the 
character sequence “[)>RS01GSyy’, where RS and GS are single characters and yy are 
two decimal digits representing a year. This character sequence represented in hex bytes 
is X'5B293E1E30311Dxxxx', where each xx is a value from X'30' to X'39'. This sequence 
indicates that the message conforms to particular open system standards. This first portion 
of the bar code data must be encoded using the MaxiCode default character set (ECI 
000003 = ISO 8859-1). This first portion of the bar code data must not contain the 
backslash escape character to change the ECI character set. The postal code must be 
one to nine decimal digits with each digit represented by the byte values from X'30' to 
X'39'. The country code must be one to three decimal digits with each digit being a byte 
value from X'30' to X'39'. The service code must also be one to three decimal digits, again 
with each digit being a byte value from X'30' to X'39'. The primary message portion of the 
MaxiCode symbol uses Enhanced Error Correction (EEC) and the secondary message 
portion of the MaxiCode symbol uses Standard Error Correction (SEC). 


When the postal code portion of the Structured Carrier Message is numeric, mode 2 
should be used. 


Structured Carrier Message - alphanumeric postal code 


This mode is designed for use in the transport industry, encoding the postal code, country 
code, and service class with the postal code being alphanumeric. The bar code data 
should be structured as described in B.2.1 and B.3.1 of the A/M International Symbology 
Specification - MaxiCode. The postal code, country code, and service class are placed in 
the primary message portion of the MaxiCode symbol and the rest of the bar code data is 
placed in the secondary message portion of the MaxiCode symbol. The first part of the bar 
code data includes the postal code, country code and service class, in that order, 
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separated by the [GS] character (X'1D'). This information may be preceded by the 
character sequence “[)>RS01GSyy’, where RS and GS are single characters and yy are 
two decimal digits representing a year. This character sequence represented in hex bytes 
is X'5B293E1E30311Dxxxx', where each xx is a value from X'30' to X'39'. This sequence 
indicates that the message conforms to particular open system standards. This first portion 
of the bar code data must be encoded using the MaxiCode default character set (ECI 
000003 = ISO 8859-1). This first portion of the bar code data must not contain the 
backslash escape character to change the ECI character set. The postal code must be 
one to six alphanumeric characters with each character being one of the printable 
characters in MaxiCode Code Set A. Postal codes less than 6 characters are padded with 
trailing spaces; postal codes longer than 6 characters are truncated. These characters 
include the letters A to Z (X'41' to X'5A’), the space character (X'20'), the special 
characters (X'22' to X'2F'), the decimal digits (X'30' to X'39'), and the colon (X'3A’'). The 
country code must be one to three decimal digits with each digit being a byte value from 
X'30' to X'39'. The service code must also be one to three decimal digits, again with each 
digit being a byte value from X'30' to X'39'. The primary message portion of the MaxiCode 
symbol uses Enhanced Error Correction (EEC) and the secondary message portion of the 
MaxiCode symbol uses Standard Error Correction (SEC). 


When the postal code portion of the Structured Carrier Message is alphanumeric, mode 3 
should be used. 


Standard Symbol 


The symbol employs EEC for the Primary Message and SEC for the Secondary Message. 
The first nine codewords are placed in the Primary Message and the rest of the 
codewords are placed in the Secondary Message. This mode provides for a total of 93 
codewords for data. If the bar code data consists of only characters from MaxiCode Code 
Set A, the number of codewords matches the number of bar code data characters. 
However, if the bar code data contains other characters, the number of codewords is 
greater than the number of bar code data characters due to the overhead of switching to 
and from the different code sets. The Code Set A consists of the byte values X'0D', X'1C’ 
to X'1E', X'20', X'22' to X'3A', and X'41' to X'5A’. 


Full ECC Symbol 


The symbol employs EEC for the Primary Message and EEC for the Secondary Message. 
The first nine codewords are placed in the Primary Message and the rest of the 
codewords are placed in the Secondary Message. This mode provides for a total of 77 
codewords for data. If the bar code data consists of only characters from MaxiCode Code 
Set A, the number of codewords matches the number of bar code data characters. 
However, if the bar code data contains other characters, the number of codewords is 
greater than the number of bar code data characters due to the overhead of switching to 
and from the different code sets. The Code Set A consists of the byte values X'0D', X'1C’ 
to X'1E', X'20', X'22' to X'3A', and X'41' to X'5A’. 


Reader Program, SEC 


The symbol employs EEC for the Primary Message and SEC for the Secondary Message. 
The data in the symbol is used to program the bar code reader system. The first nine 
codewords are placed in the Primary Message and the rest of the codewords are placed 
in the Secondary Message. This mode provides for a total of 93 codewords for data. If the 
bar code data consists of only characters from MaxiCode Code Set A, the number of 
codewords matches the number of bar code data characters. However, if the bar code 
data contains other characters, the number of codewords is greater than the number of 
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Byte 7 


Byte 8 


Byte 9 
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bar code data characters due to the overhead of switching to and from the different code 
sets. The Code Set A consists of the byte values X'0D', X'1C' to X'1E’, X'20', X'22' to 
X'3A’', and X'41' to X'5A'. 


Exception condition EC-OF05 exists if an invalid symbol-mode value is specified. 


Structured append sequence indicator 


Multiple MaxiCode bar code symbols (called structured appends) can be logically linked together 
to encode large amounts of data. The logically linked symbols can be presented on the same or 
on different physical media, and are logically recombined after they are scanned. From 2 to 8 
MaxiCode symbols can be linked. This parameter specifies where this particular symbol is logically 
linked (1&—-8) in a sequence of symbols. 


If X'00' is specified for this parameter, this symbol is not part of a structured append. Exception 
condition EC-O0F01 exists if an invalid sequence indicator value is specified. Exception condition 
EC-OFO02 exists if the sequence indicator is larger than the total number of symbols (byte 8). 


Total symbols in a structured append 


This parameter specifies the total number of symbols (2—8) that is logically linked in a sequence 
of symbols. 


If X'00' is specified for this parameter, this symbol is not part of a structured append. If this symbol 
is not part of a structured append, both bytes 6 and 7 must be X'00'", or exception condition 
EC-0F03 exists. 


Exception condition EC-OF04 exists if an invalid number of symbols is specified. 


Special-function flags 
These flags specify special functions that can be used with a MaxiCode symbol. 
BitO Zipper pattern 


If this flag is B'1', a vertical zipper-like test pattern and a contrast block is printed to the 
right of the symbol. The zipper provides a quick visual check for printing distortions. If the 
symbol presentation space is rotated, the zipper and contrast block are rotated along with 
the symbol. 


To maintain consistency among printers, the zipper pattern and contrast block should 
approximate the guideline dimensions shown inlFigure 129 on page 427] The zipper 
pattern and contrast block is made up of several filled rectangles that should be created 
such that each rectangle is as close to the specified dimensions as possible for the 
particular printer pel resolution, then the pattern is repeated to yield an evenly spaced 


zipper pattern and contrast block. 
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Guideline Dimensions for the Zipper and Contrast Block 


Contrast block anchor point 
wee P This pattern repeats for a total of 9 bars, 


with each bar 2/203 inch by 28/203 inch. 
The space between each pair of bars is 


—“(twsSs‘iis 
e 


The contrast block anchor point is 38/203 
; inch directly above the zipper anchor point. 


Zipper pattern anchor point This pattern repeats for approximately 


one inch (a total of 40 of these zipper 
teeth at 203 DPI). Each of the zipper 
teeth is made up of three 2/203 inch by 
12/203 inch rectangles. 


we 
ee 
The space between each pair of teeth is 
1/203 inch. 
«107203» «10/203 


The zipper anchor point is 19/203 inch 
right of the rightmost column of 


hexagons that forms the MaxiCode 
< 32/203 symbol and is aligned with the top of 
é the MaxiCode symbol. 


Figure 129. Example of a MaxiCode Bar Code Symbol with Zipper and Contrast Block 
Bits 1—7 


Reserved 


PDF417 Special-Function Parameters 


Offset Type |Name Range Meaning BCD1 
Range 
5 BITS Control flags 
EBCDIC EBCDIC-to-ASCIl translation: Not 
bit O B'0' Do not translate supported 
B'1' Convert data from EBCDIC to ASCII in BCD1 
Escape Escape-sequence handling: Not 
bit 1 sequence B'0' Process escape sequences supported 
handling B'1' Ignore all escape sequences in BCD1 
bits 2—7 B'000000' Reserved 
Data X'01'—X'1E' Number of data symbol characters per row Not 
6 UBIN | symbols supported 
in BCD1 
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Offset Type |Name Range Meaning BCD1 
Range 
Rows X'03'—X'5A' Desired number of rows Not 
7 UBIN X'FF' Minimum necessary rows supported 
in BCD1 
Security X'00'—X'08' Security level Not 
8 UBIN supported 
in BCD1 
Macro length | X'0000'—X'7FED' | Length of Macro PDF417 Control Block that Not 
9-10 UBIN follows supported 
in BCD1 
Macro data_ | Any value Data for Macro PDF417 Control Block Not 
1i-n supported 
in BCD1 
Byte 5 


Control flags 
These flags control how the bar code data is processed by the BCOCA receiver. 
BitO0 EBCDIC-to-ASCIl translation (for bytes 11 to end) 


If this flag is B'O', the data is assumed to begin in the default character encodation and no 
translation is done. 


If this flag is B'1', the BCOCA receiver converts each byte of the bar code data (bytes n+1 
to end) and each byte of the Macro PDF417 Control Block data (bytes 11—n) from a 
subset of EBCDIC code page 500 into the default character encodation (GLI 0) before this 
data is used to build the bar code symbol. This translation covers 181 code points which 
includes alphanumerics and many symbols; the 75 code points that are not covered by the 
translation do not occur in EBCDIC and are mapped to X'7F' (127). Refer tolFigure 130 on| 
lpage 429] for a picture showing the 181 EBCDIC code points that can be translated. 


The EBCDIC-to-ASCII translation flag should not be used if any of the 75 code points that 
have no EBCDIC equivalent are needed for the bar code data or for the Macro PDF417 
Control Block data. 


Table 5 in the Uniform Symbology Specification — PDF417 shows the full set of GLI 0 code 
points; from this set, the 75 code points that have no EBCDIC equivalent are as follows: 


158, 159, 169, 176-224, 226-229, 231-240, 242-245, 247, 249, 251-252, and 254. 


The 75 EBCDIC code points that are not covered by the translation and are thus mapped 
into X'7F' are as follows: 


x'oa", x06, Kios'—-X'0A', KM4'— X15) X17" 

Xi XB X20 — Kea", exc, KS0'— xe", 
X'33'—X'36', X'38'—X'3B', X'3E'_ X'46', X'62' 
X'64'—X'66', X'6A', X'70', X'72'—X'78', X'80', 
X'8C'—X'8E', X'9D' X'9F', X'AC'—X'AF', X'B4'—X'B6', 
X'B9', X'BC'—,X'BF', X'CA', X'CF', X'DA', X'EB', 
X'ED'—X'EF', X'FA'—X'FB', X'FD'—X'FF' 


428  PPFA User’s Guide 


Hex Digits 
it—-| O0- | 1- | 2- | 3-| 4- | 5-| 6- | 7- |) 8-| 9- | A-| B-| C-| D-| E-| F- 
2nd 4 
-Q | NUL] DLE (SP)| & ie A ‘ } \ 0 
SEO10000|SE1 70000 SPO10000 |SMO30000} SP100000 S$D150000|SM1 10000/SM1 40000}SMO70000ND 100000) 
-] | SOH| Dc1 / a j ~ A J 1 
SEO20000) SE1 80000; SP120000 LAO10000} LJO1 0000 |SD190000 LAO20000} LJO20000 INDO10000} 
-2 | STX| DC2| FS | SYN b k S B K S 2 
SEO30000|SE 190000 | SE350000} SE230000} LBO10000 | LKO10000} LSO10000 LBO20000] LKO20000) LSO20000}ND020000} 
-3 | ETX| DC3 c 1 t Cc L T 3 
SEO40000} SE200000 LCO10000} LLO10000 | LTO10000 LC020000} LLO20000 | LTO20000 |NDO30000 
-4 d m u D M | U 4 
LDO10000}LMO10000 LU010000 LDO20000 |LMO020000) LUO20000}ND040000; 
-5 | HT LF e n Vv E N Vv 5 
SE100000} SE1 10000 LEO10000 | LNO10000} L\VO10000 LEO20000 | LNO20000} LVO20000}NDO50000, 
-6 BS | ETB f 0 w F Oo |w 6 
SEO90000 | SE240000} LFO10000} LO010000 Lw010000) LFO20000]LO020000|LW020000|NDOé60000 
a ESC | EOT g p x G P xX 7 
SE280000) SEOS0000| LGO10000} LPO10000) Lxo010000) LGO20000} LPO20000] LXO20000}NDO70000 
-8 CAN h q y H Q Y 8 
SE250000 LHO10000}LQ01 0000} LYO10000 LHO20000}LQ020000} LYO20000 |NDO80000) 
-9 EM i r Zz I R Z 9 
SE260000 ISD 130000 | LIO1 0000 | LRO10000} LZ010000 LIO20000 } LRO20000} LZ020000|NDO90000) 
-A ! [ FN2 | FN3 
SPO20000 SP130000 ISMO60000 SE400000] SE410000) 
-B | VT : $ ; # ] 
SE120000} SP1 10000 |SCO30000} SPO80000|/SMO1 0000) ISMO80000 
-C | FF DC4| < * % 
SE1 30000} SE210000}SA030000 |SM040000/SM020000)SMO50000} 
-D | CR | GS | ENQ/ NAK| ( ) _ ; 
SE1 40000} SE360000} SEO60000} SE220000 |SPO60000 | SPO70000|SP090000 | SPO50000 
-E | sO | RS | ACK + ; > = FN4 
SE150000} SE370000} SEO70000 S$A010000] SP1 40000|/SAD50000 |SA040000 SE420000 
-F | sI | US | BEL] SUB| | ? "| FNI DEL 
SE160000} SE380000} SEO80000 |SE270000 |SO1 30000! SP150000) SPO40000} SE390000 SE330000 


Figure 130. Subset of EBCDIC code page 500 that can be translated to GLI O 


Bit 1 


Escape-sequence handling (for bytes n+1 to end) 


If this flag is B'0'", each X'5C' (backslash) within the bar code data is treated as an escape 
character according to the PDF417 symbology specification. 


If this flag is B'1', each X'5C' within the bar code data is treated as a normal data 
character and therefore all escape sequences are ignored. In this case, no GLI code page 
switching and no reader programming can occur within the data. 


Note: If the EBCDIC-to-ASCII translation flag is also set to B'1', all EBCDIC backslash 
characters (X'E0’) are first converted into X'5C' before the escape-sequence 
handling flag is applied. 


Bits 2—7 
Reserved 
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Byte 6 


Byte 7 


Byte 8 


Data symbol characters per row 


This parameter specifies the number of data symbol characters per row. Each row consists of a 
start pattern, a left row indicator codeword, 1 to 30 data symbol characters, a right row indicator 
codeword (omitted in a truncated symbol), and a stop pattern. The aspect ratio of the bar code 
symbol is determined by the number of data symbol characters and the number of rows. 


Exception condition EC-OF06 exists if an invalid number of data symbol characters per row is 
specified. 


Because of the Error Checking and Correction (ECC) algorithm and the data compaction method 
used by the printer when the symbol is built, the number of data symbol characters is not 
necessarily the same as the number of characters in the bar code data. 


Desired number of rows 


This parameter specifies the desired number of rows in the bar code symbol. From 3 to 90 rows 
can be specified or X'FF' can be specified to instruct the printer to generate the minimum number 
of rows necessary. The number of rows times the number of data symbol characters per row 
cannot exceed 928. Exception condition EC-OF07 exists if an invalid number of rows is specified. 


The actual number of rows generated depends on the amount of data to be encoded and on the 
security level selected. If more rows than necessary are specified, the symbol is padded to fill the 
requested number of rows. If not enough rows are specified, enough extra rows are inserted by 
the printer to produce the symbol. 


If too much data is specified to fit in the bar code symbol, exception condition EC-OF08 exists. 


Security level 


This parameter specifies the desired security level for the symbol as a value between 0 and 8. 
Each higher security level causes more error correction codewords to be added to the symbol. At 
a particular security level, a number of codewords can be missing or erased and the symbol can 
still be recovered. Also, PDF417 can recover from mis-decodes of codewords. The formula is: 
Maximum Limit >= Erasures + 2*Misdecodes. The relation of security level to error correction 
capability is as follows: 


Security level Maximum Limit >= Erasures + 2*Misdecodes 


0 


126 


254 


OINI Oa; FR] WO] mM] —-|]o 
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510 


For example, at security level 6, a total of 126 codewords can be either missing or destroyed and 
the entire symbol can still be completely recovered. The following table provides a recommended 
security level for various amounts of data: 
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Table 35. Caption. Description 


Number of Data Codewords 


Recommended Security Level 


1—40 2 
41—160 3 
161—320 4 
321— 863 5 


Exception condition EC-OFO9 exists if an invalid security level value is specified. 


Bytes 9-10 


Length of Macro PDF417 Control Block that follows 


This field specifies the length of a Macro PDF417 Control Block that follows in bytes 11—n; this 
length does not contain the length field itself. 


If X'0000' is specified, there is no Macro PDF417 Control Block specified as a special function and 
this is the last field of the special-function parameters; what follows is the bar code data itself. 


If a value between X'0001' and X'7FED' is specified, the BCOCA receiver builds a Macro PDF417 
Control Block at the end of the bar code symbol using the data in bytes 11—n. 


If an invalid length value is specified, exception condition EC-OFOC exists. 


Bytes 11—n 


Macro PDF417 Control Block data 


The special codewords “\922”, “\923”, and “\928” are used for coding a Macro PDF417 Control 
Block as defined in section G.2 of the Uniform Symbology Specification PDF417, but these 
codewords must not be used within the bar code data. Exception condition EC-2100 exists if one 
of these escape sequences is found in the bar code data. If a Macro PDF417 Control Block is 
needed, it is specified in bytes 11—n. 


The data for this Macro PDF417 Control Block must adhere to the following format; exception 
condition EC-OFOD exists if this format is not followed: 
For the symbol in a Macro PDF417 that represents the last segment of the Macro PDF417, the 
data must contain “\922”. For all symbols in a Macro PDF417, except the one representing the 


last segment: 


— A Macro PDF417 Control Block starts with a “\928” escape sequence. 
— Followed by 1 to 5 numeric digits (bytes values X'30' to X'39'), representing a segment 


index value from 1 to 99,999. 


— Followed by a variable number of escape sequences containing values from “\O00” to 

‘\899”, representing the file ID. 

— Followed by zero or more optional fields, with the following layout: 

- ‘\923” escape sequence, signalling an optional field 

- Escape sequence containing the field designator with a value from “\000” to “\O06” 

- Followed by a variable number of text characters (for field designators “\O00”, “\O03”, and 
‘\004”) or a variable number of numeric digits (for field designators “\001”, “\O02”, “\O05”, 
and “\006”). The field designators are defined in Table G1 of the Uniform Symbology 
Specification. For text characters, the byte values must be X'09', X'0A', X'0D', or from 
X'20' through X'7E'. These values represent the upper case letters A through Z, the lower 
case letters a through z, and the digits 0 through 9, plus some punctuation and special 
characters (for GLI 0). For the numeric digits, the byte values must be from X'30' through 


X'39'. 


* For field designator “\001”, the one to five numeric digits that follow represent the 
segment count. This value must be greater than or equal to the segment index value. 
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* For field designator “\O02”, the one to eleven numeric digits that follow represent the 
time stamp on the source file expressed as the elapsed time in seconds since January 
1, 1970 00:00 GMT. 


* For field designator “\O005”, one or more numeric digits must follow. 


* For field designator “\O06”, the one to five numeric digits that follow represent the 
decimal value of the 16-bit CRC checksum over the entire source file. This checksum 
value must be a decimal value from 0 through 65,535. 


Note that the file name, segment count, time stamp, sender, addressee, file size, and checksum 
are provided in the optional fields of the Macro PDF417 Control Block and the BCOCA receiver 
makes no attempt to calculate or verify these values (other than the previously stated restrictions). 
If the Macro PDF417 Control Block data does not follow these rules, exception condition EC-OFOD 
exists. Note that the Uniform Symbology Specification PDF417 has the following additional claims. 
The BCOCA receiver does not check for these claims nor does it report any exceptions conditions 
if these claims are violated: 


* If the optional Segment Count is given in the Macro PDF417 Control Block of one of the 
segments (symbols) of the macro, then it should be used in all of the segments (symbols) of the 
macro. 

¢ All optional fields, other than the Segment Count, only need to appear in one of the segments 
(symbols) of the macro. 

¢ If an optional field with the same field designator appears in more than one segment (symbol) of 
the same macro, then it must appear identically in every segment (symbol). 
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Appendix E. PPFA Keywords 


A keyword is a word in PPFA that must be entered exactly as shown. Keywords cannot be used as second 
names for commands (like FONT and OVERLAY) which can have 2 positional parameters as names. This 
is less restrictive than prior versions of PPFA. 


Note: When keywords are longer than five characters, they may be abbreviated to the first five 
characters. The shorthand form of the keyword must also be avoided as a name. For example, 
since PAGEH and CONDI are 5 character forms for PAGEHEADER and CONDITION, they cannot 


be used as second names. 


The following is a list of PPFA reserved keywords: 


ABSOLUTE 
ACROSS 
ADJUST 
AFIELD 
ALIGN 
AXIS1 
AXIS2 
BACK 
BARCODE 
BCCOLOR 
BCXPARMS 
BIN 
BINERROR 
BODY 

BOTH 

BOX 
BOXSIZE 
CHANNEL 
CIELAB 
CIRCLE 
CLRTRAP 
CMYK 
COLOR 
COLORVALUERR 
COMMENT 
CONDITION 
CONSTANT 
COPIES 
COPY 
COPYGROUP 


cP 

cS 
CUTSHEET 
CVERROR 
DBCS 
DEFINE 
DELIMITER 
DIRECTION 
DOWN 
DRAWGRAPHIC 
DUPLEX 
ELLIPSE 
ENDGRAPHIC 
ENDSPACE 
ENDSUBPAGE 
FIELD 

FILL 
FINISH 
FLASH 
FLDNUM 
FONT 
FONTFID 
FORMDEF 
FRONT 
GRAPHID 
GRID 

GROUP 
GRPHEADER 
HEIGHT 
HILITE 


HRI 
HRIFONT 
INVOKE 

J0G 

LAYOUT 
LENGTH 

LINE 
LINEONE 
LINESP 
LINETYPE 
LINEWT 
MEDIUM 
METRICTECHNOLOGY 
METTECH 

MOD 
MODWIDTH 

N 

N_UP 
NEWPAGE 
NOGROUP 
NOPRELOAD 
NORASTER 
OBID 

OBJECT 
OBKEEP 
OBNOKEEP 
OBTYPE 
OBXNAME 
0B21D 
OB2RESOURCE 


OB2TYPE 
OB2XNAME 
OCA 

OFFSET 
OPCOUNT 
OPERATION 
OPOFFSET 
OPPOS 
OTHERWISE 
OUTBIN 
OVERLAY 
OVROTATE 
PAGECOUNT 
PAGEDEF 
PAGEFORMAT 
PAGEHEADER 
PAGENUM 
PAGETRAILER 
PARTITION 
PLACE 
POSITION 
PRELOAD 
PRESENT 
PRINTDATA 
PRINTLINE 
PROCESSING 
QUALITY 
RADIUS 
RASTER 
RATIO 


RECID 
REFERENCE 
RELATIVE 
REPEAT 
REPLACE 
RES 
RESOLUTION 
RGB 
ROTATION 
SBCS 

SCOPE 
SEGMENT 
SETUNITS 
SPACE_THEN_ PRINT 
SSASTERISK 
START 
SUBGROUP 
SUPPBLANKS 
SUPPRESSION 
TEXT 

TO 
TONERSAVER 
TRCREF 
TYPE 
UDTYPE 
WHEN 

WIDTH 
XATTR 
XLAYOUT 
XSPACE 
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Appendix F. PPFA Media Names 


Table 36}lists the PPFA media names, media types, and component identifiers. 


Note: The range of component ids from 12,288 to 268,435,455 is reserved for user defined media types. 


Table 36. Registered Media Types Sorted By Media Name 


Media Name Media Type Component ID 
BSNS ENV North American business envelope 143 
COM 10 ENV Com10 envelope (9.5 x 4.125 in) 75 
C5 ENV C5 envelope (229 x 110 mm) 79 
DL ENV DL envelope (220 x 110 mm) 77 
EXEC North American executive (7.25 x 10.5 in) 65 
INDEX CD Index Card 150 
ISO A3 ISO A3 white (297 x 420 mm) 10 
ISO A3 CO ISO A3 colored 11 
ISO A4 ISO A4 white (210 x 297 mm) 0 
ISO A4 CO ISO A4 colored 1 
ISO A4 TAB ISO A4 tab (225 x 297 mm) 7 
ISO A4 THD ISO 1/3 A4 5 
ISO A4 TR ISO A4 transparent - 
ISO A5 ISO A5 white (148.5 x 210 mm) 20 
ISO A5 CO ISO A5 colored 21 
ISO A6 PC ISO A6 Postcard 152 
ISO B4 ISO B4 white (257 x 364 mm) 30 
ISO B4 CO ISO B4 colored 31 
ISO B4 ENV ISO B4 envelope 83 
ISO B5 ISO B5 white (176 x 250 mm) 40 
ISO B5 CO ISO B5 colored 41 
ISO B5 ENV ISO B5 envelope 73 
ISO C4 ENV ISO C4 envelope 93 
ISO C5 ENV ISO C5 envelope 103 
ISO LNG ENV ISO long envelope 113 
JIS B4 JIS B4 (257 x 364 mm) 42 
JIS B5 JIS B5 (182 x 257 mm) 43 
JP PC Japan postcard (Hagaki) (100 x 148 mm) 81 
JP PC ENV Japan postcard envelope (200 x 150 mm) 80 
LEDGER North American ledger (11 x 17 in) 67 
LEGAL North American legal white (8.5 x 14 in) 60 
LEGAL CO North American legal colored 61 
LEGAL TAB Legal tab (9 x 14 in) 146 
LEGAL 13 North American legal 13 (Folio) (8.5 x 14 in) 63 
LETTER North American letter white (8.5 x 11 in) 50 
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Table 36. Registered Media Types Sorted By Media Name (continued) 


Media Name Media Type Component ID 
LETTER CO North American letter colored 51 
LETTER TAB Letter tab (9 x 11 in) 145 
LETTER TR North American letter transparent 52 
MON ENV Monarch envelope (7.5 x 3.875 in) 76 
RA3 Oversize A3 (16.923 x 12.007 in) 153 
RA4 Oversize A4 (8.465 x 12.007 in) 162 
STATEMNT North American statement (5.5 x 8.5 in) 69 
US PC US Postcard 151 
9x12 ENV North American 9 x 12 envelope 133 
10x13 ENV North American 10 x 13 envelope 123 
9x12 MAN Manual (9 x 12 in) 147 
8x10 MED Media (8 x 10 in) 160 
8x10.5 MED Media (8 x 10.5 in) 148 
8.5x10 MED Media (8.5 x 10 in) 157 
9x14 MED Media (9 x 14 in) 149 
12x18 MED Media (12 x 18 in) 155 
14x17 MED Media (14 x 17 in) 154 
14x18 MED Media (14 x 18 in) 156 
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Appendix G. Fill Patterns for DRAWGRAPHIC Commands 


DOTO1 DOT02 DOTO03 


’ ee e 

©000000808688800001 
1@000000000000000 
©0000000080000801 
1@ 000088888888 888 


DOTO5 DOTO6 
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Appendix H. PPFA Messages and Codes 


At the end of processing for each command, the maximum error level encountered during processing is 
printed on the system printer, providing the error was not caused by the system printer itself. The meaning 
of the return codes is shown in|Table 37 


Table 37. Return Codes 


Return Code Severity Description 

Return Code 0 | = Information; the command is PPFA did not encounter any problems. No warning, error, 
processed. severe-error, or termination-error message was issued. 

Return Code 4 W = Warning; the command is PPFA encountered at least one non-terminating error, 
processed. solved by an assumption. At least one warning message 


was issued. No error, severe-error, or terminating-error 
message was issued. The requested function was 
probably correctly performed. The program executed to 


completion. 
Return Code 8 E = Error; the command is partially PPFA encountered at least one error, but no severe or 
processed. terminating error. A requested function may be partially 

incomplete. 


Return Code 12 S = Severe error; the command is not | PPFA encountered a severe error. The program 
processed. executed to completion, but some of the functions 
requested were not performed. 


Return Code 16 T = Termination error; the job is PPFA encountered a terminating error. The program 
terminated. terminated prematurely. 


PPFA Messages and Their Meanings 
The general format of the error message is as follows: 
All messages consist of a standard seven-character prefix, followed by the message text: 
AKQnnnS THIS IS THE MESSAGE TEXT... 
AKQ is the three-character identifier of Page Printer Formatting Aid for AIX (PPFA). 
nnn is the message number. 
S is the message-severity indicator. The indicators are defined in|Table 37 


Note: You cannot use the psfmsg command to view PPFA messages. 


In addition, PPFA errors are written to a listing file. AIX messages are written to standard error. 
Sometimes, AlX-specific errors mean that PPFA errors are not written to a listing file. 


Note: PPFA issues a maximum of 269 user errors generated within a source file, and one additional 
message is used for the message queue to indicate an out-of-storage condition. 


AKQO001E END OF COMMENT (*/) IS NOT AKQ002E DBCS STRING DOES NOT END WITH 
SPECIFIED. SHIFT-IN. 
Explanation: The end mark of a comment (*/) is not Explanation: DBCS strings in comments must 
specified. terminate with shift-in. 
System Action: The page definition or form definition System Action: The form definition or page definition 
is not generated. The syntax check may be ended. is not generated. The syntax check continues, assuming 
shift-in. 


Operator Response: Specify the end mark of a 
comment. 
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Operator Response: Specify a valid DBCS string 
enclosed by SO and SI. 


AKQO003E LITERAL DOES NOT END WITH 


APOSTROPHE. 
Explanation: A literal must end with an apostrophe. 


System Action: The page definition is not generated. 
The syntax check continues, assuming an apostrophe. 


Operator Response: Specify a valid literal enclosed 
by apostrophes. Note that an apostrophe in a literal is 
specified by consecutive double apostrophes. 


AKQO004E DBCS LITERAL DOES NOT END WITH 


SHIFT-IN AND APOSTROPHE. 


Explanation: A DBCS literal must end with shift-in and 
apostrophe. 


System Action: The page definition is not generated. 
The syntax check continues, assuming the end of the 
DBCS literal at the end of a record. 


Operator Response: Specify a valid literal ended by 
shift-in and apostrophe. 


AKQ101E COMMAND SEQUENCE IS INVALID. 


Explanation: The command sequence is invalid. 


System Action: A page definition or form definition is 
not generated. The syntax check continues from a valid 
command. 


Operator Response: Specify commands in a valid 
sequence. 


AKQ102E INVALID COMMAND (erroneous entry) IS 


SPECIFIED. 


Explanation: An invalid command is specified in the 
input data. 


System Action: A page definition or form definition is 
not generated. The syntax check continues from a valid 
command. 


Operator Response: Specify a valid command. 


AKQ103E INVALID SUBCOMMAND (value) IS 


SPECIFIED. 


Explanation: An invalid subcommand was specified in 
the input data. This message is often issued when a 
semicolon (;) is missing 


System Action: A page definition or form definition is 
not generated. The syntax check continues from the 
next keyword. 


Operator Response: Specify a valid subcommand. 
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AKQ104E = (command or parameter name) NAME IS 


NOT SPECIFIED. 
Explanation: The required name is not specified. 


System Action: A page definition or form definition is 
not generated. The syntax check continues, assuming 
blanks or default as the name. 


Operator Response: Specify the required name. 


AKQ105E REQUIRED PARAMETER IN 
(subcommand name) IS NOT 


SPECIFIED. 


Explanation: The subcommand indicated in the 
message requires a correct PPFA format. 


System Action: A page definition or form definition is 
not generated. The syntax check continues, assuming 
the default values. 


Operator Response: Refer to the command reference 
section of this publication for help in specifying a valid 
subcommand parameter. 


AKQ106E (command or parameter name) NAME IS 


SPECIFIED WITH INVALID SYNTAX. 


Explanation: The required name is specified with 
invalid syntax. See|Table 7 on page 165}for the correct 
length of names. 


System Action: A page definition or form definition is 
not generated. The syntax check continues. 


Operator Response: Specify a valid name. 


AKQi07E PARAMETER IN (subcommand name) IS 


INVALID. 


Explanation: The parameter in the subcommand is 
invalid (invalid format or out of range). 


System Action: A page definition or form definition is 
not generated. The syntax check continues, assuming 
the default values as the parameter. 


Operator Response: Specify a valid parameter value. 


AKQ108E (subcommand name) SUBCOMMAND IS 


DUPLICATED IN ONE COMMAND. 


Explanation: The subcommand indicated in the 
message was specified more than once in the same 
command. Only one such subcommand is permitted 
within this command. 


System Action: A page definition or form definition is 
not generated. The syntax check continues, ignoring the 
duplicate subcommand. 


Operator Response: Delete one subcommand. 


AKQ109E (subcommand name) SUBCOMMAND 
CONFLICTS WITH (subcommand name) 


SUBCOMMAND. 


Explanation: One subcommand conflicts with another 
(FONT, PRINTLINE, FIELD, OPCOUNT, OPPOS) 


System Action: A page definition or form definition is 
not generated. The syntax check continues, ignoring the 
latter subcommand. 


User Response: Delete one of the subcommands. 


AKQ110E THE VALUE OF THE (command name) 
SUBCOMMAND IS TOO LARGE OR 


TOO SMALL. 


Explanation: The parameter in the subcommand is 
out of range. 


IN 136.5 
MM 3467.1 
CM 346.7 
POINTS 9828.0 


PELS (L-units) 32760 


These values are specified in: 
FORMDEF N_UP OVERLAY relative_xpos 
relative_ypos 
PAGEDEF PRINTLINE OVERLAY / SEGMENT 
relative_xpos relative_ypos 


Note: The values specified for the CPI and LPI are set 
in the SETUNITS subcommand. 


System Action: No form definition or page definition is 
generated. PPFA continues syntax checking. 


Operator Response: Specify a valid parameter value. 


AKQ111E §©SUBCOMMAND SEQUENCE IS 
INVALID: (subcommand name) OCCURS 


AFTER (subcommand name) 


Explanation: For example, a WHEN subcommand 
occurs after an OTHERWISE subcommand in a 
CONDITION command. 


System Action: A page definition or form definition is 
not generated. The syntax check continues, ignoring the 
subcommand. 


Operator Response: Reorder or rewrite the 
conditions. 


AKQ112E CONDITION COMMAND DOES NOT 
ALLOW **’ IN ITS START 


SUBCOMMAND. 


Explanation: A relative position (‘*’, * +n’, or * - r’) 
was specified in a START subcommand of a 
CONDITION command. 


System Action: A page definition or form definition is 
not generated. The syntax check continues from the 
valid subcommand. 


Operator Response: Specify an absolute starting 
position. 


AKQ113E MORE THAN ONE ‘WHEN’ 
SUBCOMMAND SPECIFIED THE 


CHANGE PARAMETER. 


Explanation: More than one WHEN subcommand 
specified CHANGE for its field comparison. 


System Action: A page definition or form definition is 
not generated. The syntax check continues from the 
valid subcommand. 


Operator Response: Remove the extra 
subcommands specifying the CHANGE parameter. 


NUMBER OF PARAMETERS EXCEED 
LIMIT FOR (subcommand name) 
SUBCOMMAND OR KEYWORD. 


AKQ114E 


Explanation: The named subcommand/keyword in the 
messages limits the number of parameters that may be 
coded with a single subcommand or keyword. The 
number of parameters that can be coded with the 
named subcommand or keyword is defined in the 
command reference sections of this publication; see 
and 


(Traditional)” 


System Action: The form definition is not generated. 
The syntax check continues from the valid 
subcommand. 


Operator Response: Remove the extra parameters. 


AKQ115E REQUIRED PARAMETER(S) (PARM1, 
PARM2, ...) IN(COMMAND OR 
SUBCOMMAND) IS (ARE) NOT 


SPECIFIED. 


Explanation: This is a generic message which 
indicates one or more missing parameters on a 
subcommand or command. For example a 
DRAWGRAPHIC BOX must have a BOXSIZE 
subcommand coded. 


System Action: A page or form definition is not 
generated. 


Operator Response: Provide the correct parameter(s) 
on the command or subcommand. 


AKQ116E PARAMETER (PARM1) IN (COMMAND 


OR SUBCOMMAND) IS INVALID. 


Explanation: This is a generic message which 
indicates that a parameter in a subcommand or 
command is invalid. 
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System Action: A page or form definition is not 
generated. 


Operator Response: Provide the correct parameter 
on the command or subcommand. 


AKQ117E PARAMETER (PARM1) IN (COMMAND 
OR SUBCOMMAND) IS DUPLICATED. 
Explanation: This is a generic message which 


indicates that a parameter in a subcommand or 
command is coded more than once. For example, 
..LINEWT LIGHT BOLD... shows two different line 
weights in the same subcommand. 


System Action: A page or form definition is not 
generated. 


Operator Response: Remove one of the parameters. 


AKQ118E MUTUALLY EXCLUSIVE PARAMETERS 
ON THE (INSERT1) COMMAND OR 
SUBCOMMAND ARE DUPLICATED. 

Explanation: A command or subcommand contains 


more than one mutually exclusive parameter. For 
example, the PAGECOUNT subcommand on the 
PAGEDEF command cannot have both STOP and 
CONTINUE coded. 


System Action: 
generated. 


A page or form definition is not 


Operator Response: Remove one of the parameters. 


AKQ119E GRAPHICS-TYPE (BOX, LINE, CIRCLE, 
ELLIPSE) MUST IMMEDIATELY 
FOLLOW DRAWGRAPHIC. 

Explanation: The DRAWGRAPHIC command must 


have the graphics type (BOX, LINE, CIRCLE, ELLIPSE) 
immediately following the command. 


System Action: A page or form definition is not 
generated. 


Operator Response: Code one of the graphics types. 


AKQ120I UNKNOWN COMPONENT ID. PPFA 
WILL ASSUME IT IS SUPPORTED. 
Explanation: PPFA allows the use of numeric 


component IDs when the object type is OTHER so that 
new OTHER object types can be supported without a 
new release of PPFA. This is one of them. 


System Action: A PAGEDEF will be generated. 


Operator Response: Insure that the object type 
component id is supported by your printer and PSF 
service level. 
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AKQ121W COMMAND SEQUENCE IS INVALID. A 
(insert-1) OCCURS BEFORE A (insert-2). 


Explanation: 
a copygroup. 


For example, an overlay occurs outside 


System Action: A dummy copygroup will be created. 
This will be the first copygroup. The FORMDEF will be 
generated. 


Operator Response: Reorder the command 


statements. 


AKQ122W _ THE (insert-1) IS TOO LONG. IT IS 
TRUNCATED TO (insert-2) BYTES. 


Explanation: The input length of a parameter is 
exceeded. For example, the maximum length of a 
barcode Macro is 4096 bytes. 


System Action: Only the first (insert-2) bytes of a 
parameter will be used. Processing continues. A 
PAGEDEF will be generated. 


Operator Response: Use a shorter text parameter. 


AKQ201E (subcommand name) SUBCOMMAND IS 
NOT SPECIFIED. 

Explanation: The required subcommand is not 

specified. 


System Action: A page definition or form definition is 
not generated. The syntax check continues, assuming 
the default. 


Operator Response: Specify the required 
subcommand. 


AKQ202E SPECIFIED (command name) NAME IS 
NOT DEFINED. 
Explanation: A resource name (OVERLAY, 


SUPPRESSION, FONT, OBJECT, or QTAG) is not 
defined. 


System Action: A page definition or form definition is 
not generated. The syntax check continues. 


Operator Response: Correct the name. 


AKQ203W (command name) NAME IS 
DUPLICATED. 
Explanation: The required name must be unique for 


OVERLAY, COPYGROUP, FONT, PAGEFORMAT, 
OBJECT, or SUPPRESSION. 


System Action: 
generated. 


A page definition or form definition is 


Operator Response: Specify a unique name. 


AKQ204E = (object) NAME IS DUPLICATED. 


Explanation: The name must be unique (OVERLAY, 
COPYGROUP, FONT, PAGEFORMAT, SEGMENT). 


System Action: A page definition or form definition is 
not generated. The syntax check continues. 


Operator Response: Specify a unique name. 


AKQ205E PAGEFORMAT (pageformat name) WAS 
NOT FOUND IN THIS PAGE 


DEFINITION. 


Explanation: A WHEN or OTHERWISE subcommand 
of CONDITION specifies a PAGEFORMAT name not 
found in the page definition being processed. 


System Action: A page definition or form definition is 
not generated. The syntax check continues. 


Operator Response: Specify a pageformat name that 
is in the page definition. 


AKQ206E CONDITION (condition name) HAS 


ALREADY BEEN DEFINED. 


Explanation: A CONDITION command specifies 
LENGTH, WHEN, or OTHERWISE, and the condition 
with this condition name has already been defined by 
an earlier CONDITION command. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Define the condition only the first 
time it occurs. 


AKQ210E THE RELATIVE POSITION VALUE 


EXCEEDS THE ALLOWED RANGE 


System Action: The value specified for the relative x 
position or relative y position on the N_UP subcommand 
(for an OVERLAY) or PRINTLINE command (for an 
OVERLAY or SEGMENT) exceeds the range of +32760 
to -32760 L-units. For example, assuming the default of 
240 pels per inch is being used, the values must be 
equal to, or less than the following: 


IN 136.5 

MM 3467.1 

CM 346.7 

POINTS 9828.0 

PELS (L-units) 32760 (+ or -) 
CPI . 

LPI - 


The value specified for CPI or LPI in the SETUNITS 
command will determine whether the value will exceed 
32760 L-units. 


System Action: The page definition or form definition 
is not generated. The syntax check continues. 


Operator Response: Correct the relative x and y 


position values within the allowed range. 


AKQ211E =FRONT/BACK SIDE IS NOT SPECIFIED 


FOR DUPLEX. 


Explanation: The SUBGROUP specified with BACK 
does not exist after the SUBGROUP specified with 
FRONT, or the SUBGROUP specified with FRONT does 
not exist before the SUBGROUP specified with BACK. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Specify subgroups for both 
sides. 


AKQ212W PAPER SIDE IS SPECIFIED FOR 


SIMPLEX. 


Explanation: A subgroup specified with BOTH, 
FRONT, or BACK is invalid with single-sided printing. 


System Action: A form definition is generated, 
ignoring the subcommand specifying the paper side. 


User Response: Either delete the subcommand that 
specified the paper side or specify DUPLEX. 


AKQ213E LOGICAL PAGE POSITION EXCEEDS 


THE LIMIT. 


Explanation: The logical page position specified by 
the OFFSET subcommand in the FORMDEF or 
COPYGROUP command exceeds the limits. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ214E MORE THAN 127 SUPPRESSIONS ARE 


SPECIFIED IN ONE FORMDEF. 


Explanation: More than 127 suppressions are 
specified in one FORMDEF. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ215E MORE THAN 127 OVERLAYS ARE 


SPECIFIED IN ONE COPYGROUP. 


Explanation: More than 127 OVERLAYs are specified 
in one copy group. PPFA can issue this message for an 
N_UP subcommand that specifies more than 127 
overlays. 


System Action: No form definition is generated. The 
syntax check continues. 


User Response: Correct the error. 
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AKQ216E MORE THAN ONE RASTER OVERLAY 


IS SPECIFIED IN ONE COPYGROUP. 


Explanation: More than one raster OVERLAY is 
specified in one copy group. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ217W LOGICAL PAGE POSITION FOR BACK 
SIDE OF PAGE SPECIFIED IN SIMPLEX 


PROCESSING 


Explanation: The logical-page position specified by 
the OFFSET subcommand in a FORMDEF or 
COPYGROUP command for the back side of a page 
was specified, but simplex was specified in a 
COPYGROUP command. 


System Action: A form definition is generated, with 
the back side logical page position included, as if duplex 
had been specified. The syntax check continues. 


Operator Response: Correct the error by specifying 
duplex in the COPYGROUP command or remove the 
second set of coordinates in the OFFSET subcommand. 


AKQ218E MORE THAN 255 COPIES ARE 


SPECIFIED IN ONE COPYGROUP. 


Explanation: More than 255 copies are specified in a 
COPYGROUP. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ219E MORE THAN 127 SUBGROUPS ARE 


SPECIFIED IN ONE COPYGROUP. 


Explanation: More than 127 subgroups are specified 
in a COPYGROUP. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ220E MORE THAN 8 OVERLAYS ARE 


SPECIFIED IN ONE SUBGROUP. 


Explanation: More than eight overlays are specified in 
one SUBGROUP. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 
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AKQ221E MORE THAN 8 SUPPRESSIONS ARE 


SPECIFIED IN ONE SUBGROUP. 


Explanation: More than eight suppressions are 
specified in one SUBGROUP. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ222W DIFFERENT NUMBERS OF COPIES 
ARE SPECIFIED FOR EACH SIDE OF 
DUPLEX. 


Explanation: The number of copies for BACK side is 
not equal to those for FRONT side. 


System Action: A form definition is generated 
assuming the number of copies specified for front side. 


Operator Response: Check the number of copies. 


AKQ223E LOGICAL PAGE POSITION FOR (page 
side) SIDE OF PAGE EXCEEDS THE 


LIMIT. 


Explanation: The logical-page position specified by 
the OFFSET subcommand in a FORMDEF or 
COPYGROUP command exceeds the limit for the 
current side of the page. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct the positioning OFFSET 
parameter. 


AKQ224E MORE THAN 254 OVERLAYS ARE 


SPECIFIED IN A PAGEFORMAT. 


Explanation: The maximum number of OVERLAY 
commands is 254. PPFA can issue this message for the 
OVERLAY subcommand of the PRINTLINE command. 


System Action: A page definition is not generated. 
The syntax check continues. 


User Response: Specify a valid number of OVERLAY 
commands. 


AKQ225E CONSTANT SUBCOMMAND 
PARAMETER (parameter) SPECIFIED IN 


SIMPLEX PROCESSING 


Explanation: The BACK or BOTH parameter has 
been specified for the CONSTANT subcommand within 
simplex processing. 

System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Correct this CONSTANT 
subcommand or indicate DUPLEX. 


AKQ226E DIRECTION SUBCOMMAND ONLY 
ALLOWED WITH PRESENT 


SUBCOMMAND. 


Explanation: The DIRECTION subcommand has been 
specified, but the PRESENT subcommand has not. 


System Action: A form definition is not generated. 
The syntax check continues. 


Operator Response: Either add the PRESENT 
subcommand or remove the DIRECTION subcommand. 


AKQ227E THE ORIGIN OF THE RESOURCE 
(name) NAMED IN THE PRINTLINE 
COMMAND IS OFF THE LOGICAL 


PAGE. 


Explanation: The relative position of the PRINTLINE 
overlay or segment named is off the logical page. The 
origin of the overlay or segment specified for the 
resource named in the N_UP subcommand is off the 
medium. 


System Action: The page definition that has the 
overlay or segment in question is not generated. PPFA 
continues the syntax check, ignoring the problem. 


Operator Response: Correct the x-position and 
y-position for the OVERLAY or SEGMENT 
subcommand. 


AKQ228E — THE ORIGIN OF THE OVERLAY (overlay 
name) NAMED IN THE (commana) 


COMMAND IS OFF THE MEDIUM 


Explanation: The resource position values will position 
the resource such that at least part of the resource will 
be off the medium (physical page). 


System Action: The form definition that has the 
overlay in question is not generated. PPFA continues 
the syntax check, ignoring the problem. 


User Response: Correct the relative x-position and 
relative y-position values for the OVERLAY named in 
the N_UP subcommand. 


AKQ229W SUBGROUPS FOR FRONT AND BACK 
OF SAME SHEET USED DIFFERENT 
BINS. 


Explanation: In your subgroup command you 
specified FRONT and BACK parameters. However, your 
COPYGROUP has different bins specified. 


System Action: A form definition is generated that 
specifies the bin used for the front side. 


Operator Response: Check the number of copies and 
correct the bin setting. 


AKQ231E  PRINTLINE OR LAYOUT IS NOT 


SPECIFIED. 


Explanation: There is no PRINTLINE or LAYOUT 
command in the page format. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify either a PRINTLINE or 
LAYOUT command. 


AKQ232E REQUIRED SUBCOMMAND TEXT OR 


LENGTH IS NOT SPECIFIED. 


Explanation: A FIELD subcommand must have a 
TEXT or LENGTH subcommand. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify either a TEXT 
subcommand or a LENGTH subcommand. 


AKQ233E THE LOGICAL PAGE SIZE IS TOO 


LARGE OR TOO SMALL. 


Explanation: The specified page size is too large or 
too small. The page size must be from 1 to 32767 pels. 
The HEIGHT and WIDTH subcommands must have 
values between 1 and 32767 PELS, inclusive, or the 
same measurements expressed in other units. 


System Action: A page definition is not generated. 
The syntax check continues, assuming the defaults. 


Operator Response: Correct the error. 


AKQ234E POSITION OF LINEONE EXCEEDS THE 


LOGICAL PAGE BOUNDARY. 


Explanation: The TOP or MARGIN position specified 
by the LINEONE subcommand exceeds the logical 
page boundary. This error message is issued only if 
TOP or MARGIN is specified. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify a valid position value. 


AKQ235E MORE THAN 127 SEGMENTS ARE 


SPECIFIED IN ONE PAGEFORMAT. 


Explanation: More than 127 segments are specified in 
a single PAGEFORMAT command. PPFA can issue this 
message for the SEGMENT subcommand of the 
PRINTLINE command. 


System Action: No page definition is generated. The 
syntax check continues. 


User Response: Correct the error. 
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AKQ238E MORE THAN 127 FONTS ARE 


SPECIFIED IN ONE PAGEFORMAT. 


Explanation: More than 127 fonts are specified in one 
PAGEFORMAT or the specified TRC number exceeds 
126. PPFA counts each use of a font in more than one 
direction or rotation as a separate font. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ239E PRINT POSITION EXCEEDS THE 


LOGICAL PAGE BOUNDARY. 


Explanation: The print position specified by 
POSITION subcommand exceeds the logical page 
boundary. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ240E NUMBER OF PRINTLINES, FIELDS, 
AND CONDITIONS EXCEEDS 65,535 IN 


ONE PAGEFORMAT. 


Explanation: The total number of PRINTLINEs, 
FIELDs, and CONDITIONs exceeds 65,535 in one page 
format. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Reduce the number of 
PRINTLINEs, FIELDs, or CONDITIONSs in the page 
format. 


AKQ241E TOTAL LENGTH OF TEXT DATA 


EXCEEDS 65,534 BYTES. 


Explanation: The total length of text may be up to 
65,534 bytes. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ242E THE VALUE OF THE STARTING 


POSITION OF A RECORD IS TOO 
LARGE OR TOO SMALL. 


Explanation: The START position of a record exceeds 
the maximum (65,535) or minimum (1) value. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 
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AKQ243E DBCS LENGTH IS NOT A MULTIPLE OF 


2. 


Explanation: The number of bytes of DBCS must be a 
multiple of two. This means that the value of the 
LENGTH parameter must be a multiple of two. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify a valid length or a valid 
DBCS. 


AKQ244E INVALID CODE IS SPECIFIED IN THE 


TEXT. 


Explanation: SBCS text must be within code range 
X'00' to X'FE’. 

Valid double-byte character set (DBCS) codes are 
between X'41' and X'FE' for each byte. PPFA checks 
this range. Code X'4040' (blank) is the only exception. 
For example, the following are valid DBCS codes: 
X'4040', X'4141', X'41FE', X'FE41', X'FEFE’. 

System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify a valid code. 


AKQ245E  HEXADECIMAL TEXT IS INVALID. 


Explanation: Hexadecimal text is specified in an 
invalid format. Hexadecimal text must have an even 
length parameter and be in hexadecimal notation ('0' to 
F’). 

System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify valid hexadecimal text. 


AKQ246E NULL LITERAL IS SPECIFIED. 


Explanation: The literal has no string. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify a valid literal. 


AKQ247E KANJI NUMBER TEXT IS INVALID. 


Explanation: A Kanji number is specified in invalid 
format. Kanji number text must be a string of Kanji 
numbers delimited by commas. Each Kanji number 
must be a decimal number equal to a valid DBCS code, 
minus X'4000". 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Specify valid kanji number(s) in 
a valid format. 


AKQ248E TEXT ATTRIBUTE CONFLICTS WITH 


FONT. 


Explanation: SBCS font is specified for DBCS text 
(type G, K), or DBCS font is specified for SBCS text 
(type C). 

System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ249E_ _— TEXT ATTRIBUTE CONFLICTS WITH 


TEXT TYPE. 


Explanation: The literal type conflicts with text type. 
SBCS literal is specified as type G or X, and DBCS 
literal is specified as type C, X, or K. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ250E TRC NUMBER IS DUPLICATED. 


Explanation: The specified TRC number is duplicated 
in one page format. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Correct the error. 


AKQ251W SPECIFIED LENGTH IS SHORTER 


THAN THE TEXT AND WAS 
TRUNCATED. 


Explanation: The LENGTH parameter of the TEXT 
subcommand is shorter than the length of the specified 
literal, which is truncated to a specified length. 


System Action: The operation continues, truncating 
the literal. 


Operator Response: Check the truncation. 


AKQ252E — TEXT IS NOT THE LENGTH SPECIFIED 


BY THE LENGTH SUBCOMMAND. 


Explanation: The length of the comparison text in a 
WHEN or OTHERWISE subcommand of a CONDITION 
command is not equal to the length specified by the 
LENGTH subcommand of that CONDITION command. 


System Action: A page definition is not generated. 
The syntax check continues. 


Operator Response: Change the comparison text or 
the LENGTH parameter so that they match. 


AKQ253E TEXT IN THE ‘WHEN’ SUBCOMMAND 


IS TOO LONG. 


Explanation: Constant text ina WHEN subcommand 
of a CONDITION command is too long to fit into an 
8150-byte CCP structured field. 


System Action: A page definition or form definition is 
not generated. The syntax check continues. 


Operator Response: Shorten the field to 8000 bytes 
or fewer, and shorten the comparison text accordingly. 


AKQ254E (text type) LITERAL WAS EXPECTED 


BUT (text type) WAS FOUND. 


Explanation: An SBCS literal occurs where a DBCS 
one was expected, or vice versa. 


System Action: A page definition or form definition is 
not generated. The syntax check continues. 


Operator Response: In a FIELD command, do not 
use a DBCS literal without specifying a DBCS font. In a 
CONDITION command, do not mix SBCS and DBCS 
literals in the comparison text of a single WHEN 
subcommand. 


AKQ255E _=INVOKE SPECIFIES A SIDE FOR 
WHICH NO PLACE SUBCOMMANDS 


PUT DATA. 


Explanation: The N_UP PLACE subcommand 
contains an error that makes it incompatible with the 
value specified in the INVOKE subcommand. Either 
INVOKE BACK was specified, but PLACE n BACK was 
not specified, or INVOKE FRONT was specified, but 
PLACE n FRONT was not specified. 


System Action: No form definition is generated. 
Processing continues. 


User Response: Specify the same value (FRONT or 
BACK) for both the INVOKE and PLACE 
subcommands. 


AKQ256E INCORRECT NUMBER OF PLACE 


SUBCOMMANDS. 


Explanation: The required number of PLACE 
subcommands must be specified. 


System Action: No form definition is generated. 
Processing continues. 


User Response: When using N_UP PLACE 
subcommands with single-sided printing, the number of 
PLACE subcommands must equal the value specified 
on N_UP. When using duplex printing, the number of 
PLACE subcommands must equal two times the value 
specified on N_UP. 
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AKQ257W CONSTANT (parameter) FOUND WITH 


PLACE SUBCOMMAND. 


Explanation: The CONSTANT (parameter) 
subcommand can not be specified when N_UP PLACE 
subcommands are specified. 


System Action: A form definition is generated without 
constant forms control. The syntax check continues. 


User Response: Delete the CONSTANT (parameter) 
from the FORMDEF or COPYGROUP command. 


AKQ258W MORE THAN 122 OPERATION 
POSITIONS SPECIFIED FOR A FINISH 
OPERATION. 


Explanation: More than 122 operation finishing 
positions are specified. 


System Action: A form definition will be generated 
with 122 finishing positions. All others will be ignored. 


User Response: Move extraneous operator position 
values. 


AKQ259W OPCOUNT AND OPPOS VALUES 
SPECIFIED. OPCOUNT IGNORED. 


Explanation: Both OPCOUNT and OPPOS are 
specified. 

System Action: A form definition is not generated. 
Operator Response: If OPCOUNT is specified, 
OPPOS is ignored. When using OPPOS for controlling 


the position of each operation on the operation axis, 
OPCOUNT is ignored. 


AKQ260E ___(insert-1) not allowed with/on a 


(insert-2). 


Explanation: This is a generic message which 
indicates a contextually incorrect combination of PPFA 
commands or subcommands. 


System Action: A page definition is not generated. 


Operator Response: Correct the incorrect parameter 
and rerun the job. 


AKQ261E —_ (insert-1) requires (insert-2). 


Explanation: This is a generic message which 
indicates a missing PPFA command or subcommand. 


System Action: A page definition is not generated. 


Operator Response: Add the required parameter and 
rerun the job. 
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AKQ262E __(insert-1) specifies a (insert-2) which is 


not a (insert-3). 


Explanation: This is a generic message which 
indicates a contextually incorrect combination of PPFA 
commands or subcommands. For example that an 
ENDGRAPHIC command has specified or defaulted to a 
GRAPHID that does not match a floating 
DRAWGRAPHIC BOX or DRAWGRAPHIC LINE. 


System Action: A page definition is not generated. 


Operator Response: Correct the indicated problem. 


AKQ263E __(insert-1) exceeds (insert-2). 


Explanation: This is a generic message which 
indicates an out of bound condition for some 
parameters. For example that a DRAWGRAPHIC 
CIRCLE is positioned off the logical page. 


System Action: A page definition is not generated. 


Operator Response: Correct the indicated problem. 


AKQ264W __(insert-1) is ignored (insert-2). 


Explanation: This is a generic message which 
indicates that a contextually incorrect combination of 
PPFA commands or subcommands is clearly incorrect 
and is just ignored. For example, if a LINEONE 
subcommand was coded on a Record Format 
PAGEDEF (for example, one using LAYOUT), the 
LINEONE subcommand would just be ignored. 


System Action: A page definition is generated. 


Operator Response: No action necessary unless the 
result is not what you wanted. 


AKQ265W _(insert-1) exceeds (insert-2). 


Explanation: This is a generic message which 
indicates an out of bound condition for some 
parameters which is not necessarily critical. For 
example, when a DRAWGRAPHIC CIRCLE is 
positioned outside the margin boundary but still on the 
logical page. 


System Action: A page definition is generated. 


Operator Response: No action necessary unless the 
result is not what you wanted. 


AKQ266E PAGEDEF CONTAINS BOTH LAYOUT 


AND PRINTLINE COMMANDS. 


Explanation: Lines are placed in a record format page 
definition using LAYOUT commands or in an XML page 
definition using XLAYOUT command, otherwise lines 
are placed with PRINTLINE commands. They cannot be 
mixed in the same page definition. 


System Action: A page definition is not generated. 


Operator Response: Remove either the LAYOUT, 
XLAYOUT, or PRINTLINE commands. 


AKQ267E MORE THAN ONE DEFAULT 
PAGEHEADER OR PAGETRAILER INA 


PAGEFORMAT. 


Explanation: Only one LAYOUT DEFAULT 
PAGEHEADER or PAGETRAILER can be coded in a 
PAGEFORMAT. 


System Action: A page definition is not generated. 


Operator Response: Remove one of the duplicates. 


AKQ268E SPECIFIED MARGINS FOR THIS 
PAGEFORMAT OVERLAP. 
Explanation: Either the left margin is defined on or 


right of the right margin or the top margin is defined on 
or below the bottom margin. 


System Action: A page definition is not generated. 


Operator Response: Redefine the margins so that 
they do not overlap. 


AKQ269E A RECORD FORMAT PAGEDEF 
REQUIRES AT LEAST ONE FONT 


DEFINITION. 


Explanation: At least one font must be defined 
whether or not one is referenced. 


System Action: A page definition is not generated. 


Operator Response: Define a font. 


AKQ270E PDF417 MACRO DATA BYTE (insert-1), 
CODEPOINT (insert-2) CANNOT BE 


TRANSLATED TO GLI 0 ENCODATION 


Explanation: This is an ASCII barcode and all code 
points must ultimately end up as ASCII. The printer will 
translate EBCDIC code points if you tell it, but it will 
translate the Macro data as well as the regular data. 


When EBCDIC TO ASCII translation is requested for a 
PDF417 barcode, and the PAGEDEF is being compiled 
on an ASCII platform, and there is macro data it will be 
in ASCII. You now have mixed data which cannot be 
translated. So PPFA must translate the ASCII macro 
data to EBCDIC so that both will be the same. The 


printer can now translate the data and print the barcode. 


Now, not all EBCDIC code points will translate to GLIO 
and we have just found one. 


System Action: The PAGEDEF will not be generated. 


Operator Response: Make sure that all the PDF417 
macro text will translate to good EBCDIC code points. 


AKQ2MMS NUMBER OF MESSAGES EXCEEDS 
THE 270 ALLOWED LIMIT. PROGRAM 
TERMINATES. 


Explanation: PPFA allows only 269 messages, plus 
this one. When this limit is reached, the messages are 
printed and the program terminates. 


System Action: The program terminates. 


Operator Response: Correct the PPFA code for the 
messages issued and redo. 


AKQ3011 PAGE PRINTER FORMATTING AID 
ENDED, MAX RETURN CODE = (max 


return code). 


Explanation: This message accompanies the output 
listings of all form definitions and page definitions with 
the maximum return code for that particular object. Only 
when the return code is less than 8 is the object 
generated. 


System Action: None. 


Operator Response: None. 


AKQ302I NO ERRORS FOUND IN (resource 


name) DEFINITION. 


Explanation: One definition is processed. No 
statements were flagged in this definition. 


System Action: This definition is generated, and 
stored or replaced. 


Operator Response: None. 


AKQ303S NO CONTROL STATEMENT(S) ARE 


SPECIFIED IN INPUT DATA. 


Explanation: There are no control statements in the 
input data. 


System Action: The operation terminates. 


Operator Response: Specify a valid PPFA command. 


AKQ304S_ _—_— DEFINITION STATEMENT IS NOT 


SPECIFIED. 


Explanation: There is no FORMDEF or PAGEDEF 
command in the system input command stream. 


System Action: The operation terminates. 


Operator Response: Specify valid definition 
commands. 


AKQ305S__‘ THIS DEFINITION IS NOT STORED 


BECAUSE MEMBER ALREADY EXISTS. 


Explanation: This form definition or page definition is 
not saved because a file with the same name already 
exists in the directory (REPLACE option is NO). 
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System Action: A page definition or form definition is 
not generated. The syntax check continues to next 
definition. 


Operator Response: Check the specified form 
definition or page definition name, and specify 
REPLACE subcommand YES. Specify another form 
definition or page definition name. 


AKQ3111 FORMDEF (form definition name) |S 


GENERATED AND STORED. MAX 
RETURN CODE = (max return code). 


Explanation: The form definition is generated and 
stored. 


System Action: A form definition is generated. 


Operator Response: None. 


AKQ3121 FORMDEF (command name) IS 


GENERATED AND REPLACED. MAX 
RETURN CODE = (max return code). 


Explanation: The form definition is generated and is 
replaced. The maximum return code is listed. 


System Action: A form definition is generated. 


Operator Response: None. 


AKQ313E =FORMDEF (form definition name) IS NOT 


GENERATED. MAX RETURN CODE = 
(max return code). 


Explanation: The form definition is not generated 
because of an error. The error is indicated by another 
message. 


System Action: A form definition is not generated. 


Operator Response: Correct the error. 


AKQ3211 PAGEDEF (page definition name) |S 


GENERATED AND FILED. MAX 
RETURN CODE = (max return code). 


Explanation: The page definition is generated and 
stored. 


System Action: A page definition is generated. 


Operator Response: None. 


AKQ322I PAGEDEF (page definition name) |S 


GENERATED AND REPLACED. MAX 
RETURN CODE = (max return code). 


Explanation: The page definition is generated and is 
replaced. 


System Action: A page definition is generated. 


Operator Response: None. 
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AKQ323E PAGEDEF (page-definition name) IS NOT 
GENERATED. MAX RETURN CODE = 


(max return code). 


Explanation: The page definition is not generated 
because of an error. The error is indicated by another 
message. 


System Action: A page definition is not generated. 


Operator Response: Correct the error. 


AKQ350T AN UNRECOVERABLE PROGRAM 


ERROR OCCURRED. 
Explanation: There was an error in PPFA logic. 
System Action: The operation terminates. 


Operator Response: Use local problem-reporting 
procedures to report this message. 


AKQ360E FONT COMMAND DOES NOT CONTAIN 


SUFFICIENT INFORMATION. 


Explanation: The FONT command referred to does 
not contain enough information to generate a valid MCF. 
This is caused by having a CS parameter without a CP 
parameter, or vice versa. 


System Action: A page definition is not generated. 


Operator Response: Correct the referenced FONT 
command. 


AKQ361E FONT COMMAND SPECIFIES 


CONFLICTING PARAMETERS. 


Explanation: A FONT is specified in more than one 
way, only one of the following is allowed: 
Coded Font 
Character Set, Code Page pair (CS and CP 
parameters) 
GRID 


System Action: A page definition is not generated. 


Operator Response: Correct the referenced FONT 
command. 


AKQ362E FONT RATIO SPECIFIED WITHOUT 


FONT HEIGHT. 


Explanation: To scale a font, both the HEIGHT and 
RATIO must be specified. If a RATIO subcommand is 
found without a HEIGHT subcommand, the scaling 
information can not be calculated by PPFA. 


System Action: A page definition is not generated. 


Operator Response: Correct the referenced FONT 
command. 


AKQ363W HEIGHT SPECIFIED, WIDTH IN GRID 
IGNORED. 


Explanation: You have specified both a HEIGHT and 
GRID in the FONT command. 


System Action: None. 


Operator Response: Correct the referenced FONT 
command. 


INVALID DIRECTION WITH RELATIVE 
PRINTLINE 


AKQ364E 


Explanation: You specified an incorrect direction with 
the relative printline in your page definition source. The 
field direction must match the direction of the printline. 
The printline direction must be ACROSS. 


System Action: A page definition is not generated. 


Operator Response: Correct the referenced 
DIRECTION subcommand. 


AKQ365W COLOR AND EXTENDED COLOR 
SPECIFIED 


Explanation: Both COLOR and one of the extended 
color keywords (RGB, CMYK, HIGHLIGHT, CIELAB) 
was specified. 


System Action: Both requests are placed into the 
output resource. Output depends on printer function. 


Operator Response: If output does not print as 
expected, remove one of the specifications. 


AKQ370E BARCODE NAME WAS NOT 


PREVIOUSLY DEFINED. 


Explanation: You attempted to reference a barcode 
name that had not been previously defined. 


System Action: A page definition is not generated. 


Operator Response: Correct the referenced 
BARCODE subcommand of the FIELD command. 


AKQ371E BARCODE NAME WAS PREVIOUSLY 


DEFINED. 


Explanation: You attempted to define a barcode name 
that had been previously defined. 


System Action: A page definition is not generated. 


Operator Response: Correct the referenced 
BARCODE subcommand of the FIELD command. 


AKQ372W BARCODE MODIFICATION UNDEFINED 
FOR TYPE GIVEN. 


Explanation: You specified a modification for a bar 
code that is not defined for the type specified. 


See|Appendix D, “More About Bar Code Parameters” on 


page 395/for more information. 


System Action: A page definition is generated as 
specified. This is done so that, as new bar code types 
and modifications are introduced, you can create page 
definitions for them. However, you will receive this 
warning, because the specification could also be an 
error. 


Operator Response: Correct the referenced 
BARCODE subcommand of the FIELD command, if 
appropriate. 


AKQ373W BARCODE TYPE IS UNDEFINED. 


Explanation: You specified a bar code type that is not 
defined. 


System Action: A page definition is generated as 
specified. This is done so that, as new bar code types 
and modifications are introduced, you can create page 
definitions for them. However, you will receive this 
warning, because this specification could also be an 
error. 


Operator Response: Correct the referenced 
BARCODE subcommand of the FIELD command, if 
appropriate. 


AKQ374W INVALID DATA LENGTH FOR 
SELECTED BARCODE TYPE AND 


MODIFICATION. 


Explanation: You specified a data length for a defined 
barcode type and modification that is invalid for that 
combination of type and modification. 


See|Appendix D, “More About Bar Code Parameters” on 


page 395/for more information. 


System Action: A page definition is generated as 
specified. This is done so that, as new bar code types 
and modifications are introduced, you can create page 
definitions for them. However, you will receive this 
warning, because this specification could also be an 
error. 


Operator Response: Correct the referenced 
BARCODE subcommand of the FIELD command, if 
appropriate. 


AKQ401E EXEC PARAMETER IS INVALID. 


Explanation: The program parameter specification is 
invalid. 


System Action: A page definition or form definition is 
not generated. The syntax check continues. 


Operator Response: Specify a valid program 
parameter. 


Appendix H. PPFA Messages and Codes 451 


AKQ402T ERROR OCCURRED DURING ATTEMPT 


TO OBTAIN STORAGE 
Explanation: conditions generate this message: 


1. Exceeds the available size to hold the compiled 
data for the page definition and form definition. 


2. Insufficient available disk space on the file system to 
write the output of the compiler. 


3. Exceeds the limit of 269 user errors generated 
within a PPFA source file. 


System Action: The operation terminated. 


Operator Response: 
1. Increase the region or VM program size. 


2. Increase the size of the file system or specify a 
directory on another file system that has more disk 
space. 


3. Fix the errors reported to this point and re-run 
PPFA. 


AKQ403T ERROR OCCURRED DURING ATTEMPT 


TO FREE STORAGE. 


Explanation: A system error occurred while PPFA 
attempted to free disk space at the end of an execution. 


System Action: The operation terminates. 


Operator Response: Use local problem-reporting 
procedures to report this message. 


AKQ404T  SYSIPT OPEN FAILURE. 
Explanation: SYSIPT cannot be opened. 
System Action: The operation terminates. 


Operator Response: Assign a valid input data file. 


AKQ405T INSUFFICIENT STORAGE TO EXECUTE 


PPFA. 


Explanation: The region size is too small to execute 
PPFA. 


System Action: The operation terminates. 


Operator Response: Increase the region size 
available to the job. 


AKQ410T = (Librarian error message). 
Explanation: The message describes a librarian error. 
System Action: The operation terminates. 


Operator Response: Contact a system programmer. 
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AKQ411T FORMDEF LIBRARY OPEN FAILURE. 


Explanation: The FORMDEF library cannot be 
opened. 


System Action: The operation terminates. 


Operator Response: Assign a valid FORMDEF 
library. 


AKQ412T FORMDEF LIBRARY I/O ERROR. 


Explanation: An I/O error occurred during an 
attempted access of a form definition directory. 


System Action: The operation terminates. 


Operator Response: Check the permissions of the 
directory. If you do not have access, contact the owner 
of the directory. If this does not resolve the problem, 
contact a system programmer. 


AKQ413T FORMDEF DIRECTORY CANNOT BE 


UPDATED. 


Explanation: The FORMDEF member cannot be 
registered on the directory. 


System Action: The operation terminates. 


Operator Response: Contact a system programmer. 


AKQ414T FORMDEF LIBRARY CLOSE FAILURE. 


Explanation: A form definition directory cannot be 
closed. 


System Action: The operation terminates. 


Operator Response: Use local problem-reporting 
procedures to report this message. 


AKQ415T PAGEDEF LIBRARY OPEN FAILURE. 


Explanation: The PAGEDEF library cannot be 
opened. 


System Action: The operation terminates. 


Operator Response: Assign a valid PAGEDEF library. 


AKQ416T PAGEDEF LIBRARY I/O ERROR. 


Explanation: 1/O error occurs during an attempted 
access of a page definition directory. 


System Action: The operation terminates. 


Operator Response: Check the permissions of the 
directory. If you do not have access, contact the owner 
of the directory. If this does not resolve the problem, 
contact a system programmer. 


AKQ417T PAGEDEF DIRECTORY CANNOT BE 


UPDATED. 


Explanation: A page definition file cannot be 
registered on the directory. 


System Action: The operation terminates. 


Operator Response: Contact a system programmer. 


AKQ418T PAGEDEF LIBRARY CLOSE FAILURE. 


Explanation: A page definition directory cannot be 
closed. 


System Action: The operation terminates. 


Operator Response: Use local problem-reporting 
procedures to report this message. 


AKQ420T SYSTEM ERROR. ABEND CODE = 


(ABEND code). 


Explanation: System forces PPFA to terminate 
abnormally. 


System Action: The operation terminates. 


Operator Response: Contact a system programmer. 
Refer to the documentation for your operating system. 


AKQ421T FORMDEF LIBRARY IS FULL. 


Explanation: The file system into which PPFA 
attempted to save the form definition is full. 


System Action: The operation terminates. 


Operator Response: Increase the size of the file 
system or specify a directory on a file system that has 
more disk space. 


AKQ422T PAGEDEF LIBRARY IS FULL. 


Explanation: The file system into which PPFA 
attempted to save the page definition is full. 


System Action: The operation terminates. 


Operator Response: Increase the size of the file 
system or specify a directory on a file system that has 
more disk space. 


AKQ501T SYSIN OPEN FAILURE. 


Explanation: The PPFA input source file cannot be 
opened. 


System Action: The operation terminates. 


Operator Response: Specify a valid input source file. 


AKQ502T SPANNED RECORD OF SYSIN IS NOT 


SUPPORTED. 


Explanation: The spanned record of the PPFA input 
source file is not supported. 


System Action: The operation terminates. 


Operator Response: Specify a valid input record 
format. 


UNDEFINED LENGTH RECORD OF 
SYSIN IS NOT SUPPORTED. 


AKQ503T 


Explanation: An undefined length record of PPFA 
input source file is not supported. 


System Action: The operation terminates. 


Operator Response: Specify a valid input record 
format. 


AKQ504T LOGICAL RECORD LENGTH OF SYSIN 


EXCEEDS LIMIT. 


Explanation: The logical record length of the PPFA 
input source file exceeds limit which is 100 bytes except 
for the OS/390 variable length which is 104 and AIX 
which is 254. 


System Action: The operation terminates. 


Operator Response: Correct the logical record length 
of the file. 


AKQ510T FORMDEF/PAGEDEF LIBRARY OPEN 


FAILURE. 


Explanation: The FORMDEF or PAGEDEF directory 
cannot be opened. 


System Action: The operation terminates. 


Operator Response: Specify a valid FORMDEF or 
PAGEDEF or check to make sure that the directory is 
correct. 


AKQ511T 1/0 ERROR OCCURRED DURING 


(FORMDEF/PAGEDEF) DIRECTORY 
SEARCH. RETURN CODE = (return 
code) REASON CODE = (reason code) 


Explanation: 1/O error occurred while performing FIND 
function. 


System Action: The operation terminates. 


Operator Response: Contact a system programmer. 


AKQ512T LOGICAL RECORD LENGTH OF 


FORMDEF/PAGEDEF EXCEEDS LIMIT. 


Explanation: The logical record length exceeds 
maximum or minimum value. 


System Action: The operation terminates. 
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Operator Response: Specify a filename that has a 
valid record length. 


AKQ513T BLOCK SIZE OF FORMDEF/PAGEDEF 


EXCEEDS LIMIT. 


Explanation: The block size exceeds maximum or 
minimum value. 


System Action: The operation terminates. 


Operator Response: Assign a filename that has a 
valid block size. 


AKQ514T UNDEFINED LENGTH RECORD IS NOT 
SUPPORTED IN FORMDEF/PAGEDEF 


LIBRARY. 


Explanation: An undefined length record is not 
supported in FORMDEF/PAGEDEF directory. 


System Action: The operation terminates. 


Operator Response: Assign a valid record format. 


AKQ515T FIXED LENGTH RECORD IS NOT 
SUPPORTED IN FORMDEF/PAGEDEF 


LIBRARY. 


Explanation: The fixed length record is not supported 
in the FORMDEF or PAGEDEF library. 


System Action: The operation terminates. 


Operator Response: Assign a valid record format. 


AKQ516T NO CONTROL CHARACTER RECORD 
IS SUPPORTED IN 


FORMDEF/PAGEDEF LIBRARY. 


Explanation: No control character record is supported 
in FORMDEF/PAGEDEF directory. 


System Action: The operation terminates. 


Operator Response: Assign a valid record format. 


AKQ517T NO SPACE IN FORMDEF/PAGEDEF 


DIRECTORY. 


Explanation: No space was available in the 
FORMDEF directory or the PAGEDEF directory to add 
or replace the resource. 


System Action: The operation terminates. 


Operator Response: Increase the directory space or 
specify a directory on another file system that has more 
disk space. 
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AKQ518T I/O ERROR OCCURRED WHILE 
UPDATING FORMDEF/PAGEDEF 
DIRECTORY. RETURN CODE = (return 


code). REASON CODE = (reason code). 


Explanation: A permanent I/O error was detected, or 
the specified data control block is not opened, or 
insufficient disk space exists to perform the write 
function. 


System Action: The operation terminates. 


Operator Response: Contact a system programmer. 


AKQ519T I/O ERROR OCCURRED DURING 


WRITE. 
Explanation: The error message is displayed. 
System Action: The operation terminates. 


Operator Response: Contact a system programmer. 


AKQ520T SPANNED RECORD IS NOT 
SUPPORTED IN FORMDEF/PAGEDEF 


LIBRARY. 


Explanation: The spanned record is not supported in 
the FORMDEF or PAGEDEF library. 


System Action: The operation terminates. 


Operator Response: Remove the SPAN attribute and 
assign a valid dataset. 


AKQ522T ~~ BLOCK SIZE IS NOT SPECIFIED FOR 


FORMDEF/PAGEDEF DATA SET. 


Explanation: A block size is not specified for 
FORMDEF/PAGEDEF data set. 


System Action: The operation terminates. 


Operator Response: Specify a BLKSIZE in the DD 
statement. 


AKQ540T SYSTEM ABEND (code) OCCURRED IN 


PPFA PROCESS. 


Explanation: A system ABEND (code) occurred in 
PPFA/OS/390 process. Termination processing was 
performed by the ESTAE macro instruction. 


System Action: The operation terminates. 


Operator Response: Contact a system programmer. 
Refer to System Messages for your operating system. 


AKQ541T USER ABEND (code) OCCURRED IN 


PPFA/OS/390 PROCESS. 


Explanation: A user ABEND (code) occurred in 
PPFA/OS/390 process. Termination processing was 
performed by the ESTAE macro instruction. 


System Action: The operation terminates. 


Operator Response: Use local problem-reporting 
procedures to report this message. 


AKQ600T INPUT FILENAME NOT SPECIFIED. 
Explanation: You did not specify an input filename. 
System Action: The operation terminates. 


Operator Response: Enter the input filename. 


AKQ601T INPUT FILETYPE NOT SPECIFIED. 
Explanation: You did not specify an input filetype. 
System Action: The operation terminates. 


Operator Response: Enter the input filetype. 


AKQ602T COMMAND SYNTAX IS NOT VALID. 


Explanation: The command syntax you entered was 
not accepted. 


System Action: The operation terminates. 


Operator Response: Enter a valid command. 


AKQ603T  FILEMODE FOR 
(FORMDEF/PAGEDEFI/LISTING) IS 


INVALID. 


Explanation: You entered an invalid filemode for 
FORMDEF, PAGEDEF, or LISTING. 


System Action: The operation terminates. 


Operator Response: Enter a valid file extension. 


AKQ604T INVALID PARAMETER IS SPECIFIED IN 
(FORMDEF/PAGEDEF/LISTING/SIZE) 


OPTION. 


Explanation: You entered an invalid parameter for 
FORMDEF, PAGEDEF, LISTING, or SIZE. 


System Action: The operation terminates. 


Operator Response: Enter a valid option parameter. 


AKQ605T (FORMDEF/PAGEDEF/LISTING/SIZE) 


KEYWORD IS DUPLICATED. 


Explanation: You entered a duplicate keyword for 
FORMDEF, PAGEDEF, LISTING, or SIZE. 


System Action: The operation terminates. 


Operator Response: Enter a unique keyword. 


AKQ606T FILETYPE FOR 
(FORMDEF/PAGEDEF/LISTING) NOT 


SPECIFIED. 


Explanation: The filetype for FORMDEF, PAGEDEF, 
or LISTING was not entered. 


System Action: The operation terminates. 


Operator Response: Enter an appropriate filetype. 


AKQ607T INVALID KEYWORD SPECIFIED. 


Explanation: The keyword you entered was not 
accepted. 


System Action: The operation terminates. 


Operator Response: Enter a valid keyword. 


AKQ608T INVALID SIZE PARAMETER SPECIFIED. 
Explanation: The size parameter specified is not valid. 
System Action: The operation terminates. 


Operator Response: Enter a valid size parameter. 


AKQ610T SIZE PARAMETER VALUE EXCEEDS 


THE ALLOWABLE MAXIMUM. 


Explanation: The size entered exceeds the maximum 
allowable. 


System Action: The operation terminates. 


Operator Response: Enter a valid size value. 


AKQ611T SIZE PARAMETER VALUE IS TOO 


SMALL. 


Explanation: The size entered is too small for 
executing in PPFA/VM. 


System Action: The operation terminates. 


Operator Response: Enter a valid size value. 


AKQ612T — INVALID FILE IDENTIFIER ‘*’ 


SPECIFIED FOR INPUT FILE. 


Explanation: “’ is specified for input filename or 
filetype. 


System Action: The operation terminates. 


Operator Response: Enter a valid filename or filetype. 


AKQ613T SIZE PARAMETER VALUE IS MISSING. 
Explanation: You did not specify a size parameter 
System Action: The operation terminates. 


Operator Response: Specify a valid size parameter. 


AKQ620T ‘INPUT FILE WAS NOT FOUND. 


Explanation: The input filename entered was not 
found. 


System Action: The operation terminates. 


Operator Response: Correct the input filename. 
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AKQ621T NO READ/WRITE (file mode) DISK 
ACCESSED FOR 
(INPUT/LISTING/FORMDEF/PAGEDEF 


/OUTPUT). 


Explanation: The disk on which the file is saved 
cannot be read from or written to because it either was 
not accessed or was accessed using an invalid access 
mode. 


System Action: The operation terminates. 


Operator Response: Access the file system using a 
valid access mode. 


AKQ622T ‘INPUT FILE EXCEEDS THE 
ALLOWABLE LOGICAL RECORD 


LENGTH MAXIMUM. 


Explanation: The logical record length of the input file 
exceeds the limit which is 100 bytes except the OS/390 
variable record length is 104 and AIX is 254. 


System Action: The operation terminates. 


Operator Response: Correct the logical record length 
of the file. 


AKQ624T I/O ERROR OCCURRED IN 
(AKQINIO/AKQLBIO/AKQPRIO) 
MODULE. RC = (return code from 


FWRITE/FGETS macro instruction). 


Explanation: An I/O error occurred during either 
FGETS or FWRITE processing of module AKQINIO, 
AKQLBIO, or AKQPRIO. 


System Action: The operation terminates. 


Operator Response: Contact your system 
programmer. Refer to the return code in AlX Operating 
System Messages 


AKQ625T __ODISK (file mode) IS FULL. 


Explanation: Not enough space is available on the 
specified file system to write the file. 


System Action: The operation terminates. 


Operator Response: Erase some files from the 
specified file disk and re-execute. 


AKQ639T ABEND EXIT ROUTINE FAILED TO 
EXECUTE. RC = (return code from 


ABNEXIT macro) 


Explanation: ABEND exit routine cannot be 
established. 


System Action: The operation terminates. 


Operator Response: Contact your system 
programmer. Refer to the return code in AlX Operating 
System Messages 
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AKQ640T SYSTEM ABEND (code) OCCURRED IN 


PPFA/VM PROCESS. 


Explanation: A system ABEND occurred during 
processing. The ABEND exit routine ended processing. 


System Action: The operation terminates. 


Operator Response: Use local problem-reporting 
procedures to report this message. 


AKQ641T USER ABEND (code) OCCURRED IN 


PPFA/VM PROCESS. 


Explanation: A user-initiated ABEND occurred during 
processing. The ABEND exit routine ended the 
processing. 


System Action: The operation terminates. 


Operator Response: Use local problem-reporting 
procedures to report this message. 


AKQ700I SIZE PARAMETER IS NO LONGER 


NECESSARY IN PPFA/370. 


Explanation: The storage required to contain the 
messages and control blocks is not automatically set at 
32K and 128K respectively. If the control block storage 
is used up, an additional 128K will be gotten and 
chained to the previous. All storage necessary to 
perform the compile will be obtained during processing. 


System Action: The compile process continues. 


Operator Response: None. 
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This information was developed for products and services offered in the U.S.A. 


IBM may not offer the products, services, or features discussed in this document in other countries. 
Consult your local IBM representative for information on the products and services currently available in 
your area. Any reference to an IBM product, program, or service is not intended to state or imply that only 
that IBM product, program, or service may be used. Any functionally equivalent product, program, or 
service that does not infringe any IBM intellectual property rights may be used instead. However, it is the 
user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. 


IBM may have patents or pending patent applications covering subject matter described in this document. 
The furnishing of this document does not give you any license to these patents. You can send license 
inquiries, in writing, to: 


IBM Director of Licensing 

IBM Corporation 

North Castle Drive 

Armonk, NY 10504-1785 U.S.A. 


The following paragraph does not apply to the United Kingdom or any other country where such 
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION 
PROVIDES THIS PUBLICATION "AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR 
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, 
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer 
of express or implied warranties in certain transactions, therefore, this statement may not apply to you. 


This information could include technical inaccuracies or typographical errors. Changes are periodically 
made to the information herein; these changes will be incorporated in new editions of the publication. IBM 
may make improvements and/or changes in the product(s) described in this publication at any time without 
notice. 


Any references in this information to non-IBM Web sites are provided for convenience only and do not in 
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of 
the materials for this IBM product and use of those Web sites is at your own risk. 


IBM may use or distribute any of the information you supply in any way it believes appropriate without 
incurring any obligation to you. 


For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property 
Department in your country or send inquiries, in writing, to: 


IBM World Trade Asia Corporation 
Licensing 

2-31 Roppongi 3—chome, Minato-ku 
Tokyo 106, Japan 


Licensees of this program who wish to have information about it for the purpose of enabling: (i) the 
exchange of information between independently created programs and other programs (including this one) 
and (ii) the mutual use of the information which has been exchanged, should contact: 


IBM Printing Systems Division 
Department H7FE Building 004M 
Information Development 

PO Box 1900 

Boulder CO 80301-9191 USA 


© Copyright IBM Corp. 1985, 2002 457 


Such information may be available, subject to appropriate terms and conditions, including in some cases, 
payment of a fee. The licensed program described in this document and all licensed material available for 
it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License 
Agreement or any equivalent agreement between us. 


Any performance data contained herein was determined in a controlled environment. Therefore, the results 
obtained in other operating environments may vary significantly. Some measurements may have been 
made on development-level systems and there is no guarantee that these measurements will be the same 
on generally available systems. Furthermore, some measurement may have been estimated through 
extrapolation. Actual results may vary. Users of this document should verify the applicable data for their 
specific environment. 


Information concerning non-IBM products was obtained from the suppliers of those products, their 
published announcements or other publicly available sources. IBM has not tested those products and 
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. 
Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. 


All IBM prices shown are IBM’s suggested retail prices, are current and are subject to change without 
notice. Dealer prices may vary. 


This information contains examples of data and reports used in daily business operations. To illustrate 
them as completely as possible, the examples include the names of individuals, companies, brands, and 
products. All of these names are fictitious and any similarity to the names and addresses used by an 
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COPYRIGHT LICENSE: 


This information contains sample application programs in source language, which illustrates programming 
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in 
any form without payment to IBM, for the purposes of developing, using, marketing or distributing 
application programs conforming to the application programming interface for the operating platform for 
which the sample programs are written. These examples have not been thoroughly tested under all 
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these 
programs. You may copy, modify, and distribute these sample programs in any form without payment to 
IBM for the purposes of developing, using, marketing, or distributing application programs conforming to 
IBM’s application programming interfaces. 


Each copy or any portion of these sample programs or any derivative work, must include a copyright 
notice as follows: 


© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © 
Copyright IBM Corp. _enter the year or years_. All rights reserved. 


If you are viewing this information softcopy, the photographs and color illustrations may not appear. 


For online versions of this book, we authorize you to: 

* Copy, modify, and print the documentation contained on the media, for use within your enterprise, 
provided you reproduce the copyright notice, all warning statements, and other required statements on 
each copy or partial copy. 

* Transfer the original unaltered copy of the documentation when you transfer the related IBM product 
(which may be either machines you own, or programs, if the program’s license terms permit a transfer). 
You must, at the same time, destroy all other copies of the documentation. 


You are responsible for payment of any taxes, including personal property taxes, resulting from this 
authorization. 
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Your failure to comply with the terms above terminates this authorization. Upon termination, you must 
destroy your machine readable documentation. 


Programming Interfaces 


This publication includes documentation of intended Programming Interfaces that let the customer write 
programs to obtain the services of the Page Printer Formatting Aid (PPFA). 


Trademarks 


The following terms appear in this publication and are either trademarks or registered trademarks of the 
IBM Corporation: 

Advanced Function Common Control Unit 

Advanced Function Presentation 

Advanced Function Printing 

AFCCU 

AFP 

AIX 

AIX/6000 

OS/400 

Bar Code Object Content Architecture 

BCOCA 

IBM 

Infoprint® 

Infoprint Server for OS/390® 

Intelligent Printer Data Stream 

IPDS 

Mixed Object Document Content Architecture 

MO:DCA 

PrintWManager 

Print Services Facility 

PSF 

OS/400 

RISC System/6000 

S/370 


The following terms appear in this publication and are trademarks of other companies: 
¢ Windows and Windows NT are registered tradmarks of the Microsoft Corporation. 
¢ UNIX is a registered trademark of The Open Group in the United States and other countries. 


EuroReady 


The Page Printer Formatting Aid (PPFA) is capable of processing data containing the euro sign. Font 
character sets and code pages that contain and map the euro sign consistently with the application must 
be present either in a host library or in the printer. AFP fonts that support the euro sign are included in the 
AFP Font Collection. 


Year 2000 Ready 


PPFA does not have date dependencies and is therefore Year 2000 ready. When used in accordance with 
its associated documentation, PPFA is capable of correctly processing, providing, and receiving date data 
within and between the twentieth and twenty-first centuries, provided all other products used with PPFA 
(including software, hardware and firmware) properly exchange accurate date data with it. 


Notices 459 


460 _ PPFA User’s Guide 


Glossary 


Source Identifiers 


This publication includes terms and definitions 
from the /BM Dictionary of Computing, 
ZC20-1699. 


Definitions reprinted from the American National 
Dictionary for Information Processing Systems are 
identified by the symbol (A) following the 
definition. 


Definitions reprinted from a published section of 
the International Organization for Standardization’s 
Vocabulary—Information Processing or from a 
published section of the ISO Vocabulary—Office 
Machines are identified by the symbol (1) following 
the definition. Because many ISO definitions are 
also reproduced in the American National 
Dictionary for Information Processing Systems , 
ISO definitions may also be identified by the 
symbol (A). 


Definitions reprinted from working documents, 
draft proposals, or draft international standards of 
ISO Technical Committee 97, Subcommittee 1 
(Vocabulary) are identified by the symbol (T) 
following the definition, indicating that final 
agreement has not yet been reached among its 
participating members. 


Definitions that are specific to IBM products are so 
labeled, for example, “In SNA,” or “In the 3820.” 


The following definitions are provided as 
supporting information only, and are not intended 
to be used as a substitute for the semantics 
described in the body of this document. 


References 


The following cross-references are used in this 
glossary: 


Contrast with. This refers to a term that has an 
opposed or substantively different meaning. 


See. This refers the reader to multiple-word terms that 
have the same last word. 


See also. This refers the reader to related terms that 
have a related, but not synonymous, meaning. 
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Synonym for. This indicates that the term has the 
same meaning as a preferred term, which is defined in 
its proper place in the glossary. 


Synonymous with. This is a backward reference from 
a defined term to all other terms that have the same 
meaning. 


Terms 


A 


ACIF. (1) AFP conversion and indexing facility. (2) A 
print server utility program that converts a print file into 
AFP, MO:DCA-P, creates an index file for input data, 
and collects resources used by an AFP document into a 
separate file. 


advanced function printing (AFP). The ability of 
program products to place text and image data at any 
addressable point on the page. 


AFP. Advanced function printing. 


AIX operating system. |IBM’s implementation of the 
UNIX operating system. The RS/6000© system, among 
others, runs the AIX operating system. 


all-points addressability. The capability to address, 
reference, and position data elements at any 
addressable position in a presentation space or ona 
physical medium. An example of all points addressability 
is the positioning of text, graphics, and images at any 
addressable point on the physical medium. See also 
picture element. 


all-points-addressable mode. Synonym for page 
mode. 


alphanumeric string. A sequence of characters 
consisting solely of the letters a through z and the 
numerals 0 through 9. 


American National Standards Institute (ANSI). An 
organization consisting of producers, consumers, and 
general interest groups. ANSI establishes the 
procedures by which accredited organizations create 
and maintain voluntary industry standards in the United 


States. It is the United States constituent body of the 
ANSI. See American National Standards Institute. 
APA. All points addressable. 

application. (1) The use to which an information 


system is put. (2) A collection of software components 
used to perform specific types of work on a computer. 
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application program. A program written for or by a 
user that applies to the user’s work. 


ascender. The parts of certain lowercase letters, such 
as b, d, or f, which at zero-degree character rotation 
rise above the top edge of other lowercase letters such 
as a, c, and e. Contrast with descender. 


attribute. A property or characteristic of one or more 
constructs. For example, [character attributel|color| 
current drawing attributes, default drawing 
attributes, line attributes, marker attributes, and pattern 
attributes. 


bar. In bar codes, the darker element of a printed bar 
code symbol. 


bar code. An array of parallel rectangular bars and 
spaces that together represent data elements or 
characters of a particular type. The bars and spaces are 
arranged in a predetermined pattern following 
unambiguous rules defined by the symbology. 


bar code command set. In the|IPDS| architecture, a 


collection of|commandg used to present|bar code 
symbolp in a page segment| or[overlay| 


bar code density. The number of characters per inch 
(cpi) in a}bar code symbology] In most cases, the range 
is three to ten cpi. 


bar code object area. The rectangular area ona 
logical page into which a bar code presentation space is 
mapped. 


Bar Code Object Content Architecture (BCOCA). An 
architected collection of constructs used to interchange 
and present bar code data. 


bar code symbol. A combination of characters 
including start and stop characters, quiet zones, data 
characters, and check characters required by a 
particular bar code type, that form a complete, 
scannable entity. 


bar code symbology. A bar code language. Bar code 
symbologies are defined and controlled by various 
industry groups and standards organizations. Bar code 
symbologies are described in public domain bar code 
specification documents. Synonymous with symbology. 
Examples of bar code symbology include: Canadian 
Grocery Product Code (CGPC), European Article 
Numbering (EAN), Japanese Article Numbering (JAN), 
and Universal Product Code (UPC). 


bar height. In bar codes, the bar dimension 


perpendicular to the bar width. Synonymous with bar 
length and height. 


462 PPFA User’s Guide 


bar length. In bar codes, the bar dimension 
perpendicular to the bar width. Synonymous with bar 
length and height. 


bar width. In bar codes, the thickness of a bar 
measured from the edge closest to the symbol start 
character to the trailing edge of the same bar. 


baseline. A conceptual line with respect to which 
successive characters are aligned. 


baseline direction. The direction in which successive 
lines of text appear on a logical page. 


BCOCA. See Bar Code Object Content Architecture. 


bin. The standard-size paper source on cut-sheet 
page printers that have more than one paper source. 
Each printer is set up with either A4 or letter-size paper 
as the standard size. Contrast with cassette. 


BITS. A data type for architecture syntax, indicating 
one or more bytes to be interpreted as bit string 
information. 


body. (1) Ona printed page, the area between the top 
and bottom margins that can contain data. (2) Ina 
book, the portion between the front matter and the back 
matter. 


boldface. (1) A heavy-faced type. (2) Printing in 
heavy-faced type. 


Cc 


carriage control character. If present, the first 
character of an output record (line) that is to be printed 
or spaced; it determines how many lines should be 
skipped before the line. 


cassette. A removable storage device that is the 
source for alternate sizes of paper on page printers that 
have more than one paper source. Contrast with bin. 


CDB20F7. A parameter that specifies a bar code type 
of Codabar, 2-of-7, Automatic Identification 
Manufacturers Uniform Symbol Specification-Codabar. 


CGPC. See Canadian Grocery Product Code. 


CHAR. A data type for architecture syntax, indicating 
one or more bytes to be interpreted as character 
information. 


character. (1) Amember of a set of elements used for 
the organization, control, or representation of data. A 
character can be either a graphic character or a control 
character. (2) In bar codes, a single group of bars and 
spaces that represent an individual number, letter, 
punctuation mark, or other symbol. 


character ascender. See ascender. 


character attribute. A characteristic that controls the 
appearance of a character or character string. 


character baseline. A conceptual reference line that is 
coincident with the X axis of the character coordinate 
system. 


character code. An element of a code page or a cell 
in a code table to which a character can be assigned. 
The element is associated with a binary value. The 
assignment of a character to an element of a code page 
determines the binary value that will be used to 
represent each occurrence of the character in a 
character string. 


character descender. See descender. 


character identifier. The unique name for a graphic 
character. 


character rotation. The alignment of a character with 
respect to its character baseline, measured in degrees 
in a clockwise direction. Examples are 0°, 90°, 180°, 
and 270°. Zero-degree character rotation exists when a 
character is in its customary alignment with the 
baseline. Character rotation and font inline sequence 
are related in that character rotation is a clockwise 
rotation; font inline sequence is a counterclockwise 
rotation. 


character set. A finite set of different graphic or 

that is complete for a given purpose. 
For example, the character set in ISO Standard 646, 
7-bit Coded Character Set for Information Processing 
Interchange 


character set attribute. An attribute used to specify a 
coded font. 


code page. (1) A resource object containing 
descriptive information, graphic character identifiers, and 
code points corresponding to a coded graphic character 
set. Graphic characters can be added over time; 
therefore, to specifically identify a code page, both a 
GCSGID and a CPGID should be used. See also coded 
graphic character set. (2) A set of assignments, each of 
which assigns a code point to a character. Each code 
page has a unique name or identifier. Within a given 
code page, a code point is assigned to one character. 
More than one character set can be assigned code 
points from the same code page. 


Code Page Global Identifier (CPGID). A unique code 
page identifier that can be expressed as either a 
two-byte binary or a five-digit decimal value. 


code point. A unique bit pattern that can serve as an 
element of a code page or a site in a code table, to 
which a character can be assigned. The element is 
associated with a binary value. The assignment of a 
character to an element of a code page determines the 
binary value that will be used to represent each 


occurrence of the character in a character string. Code 
points are one or more bytes long. 


Code39. A bar code symbology characterized by a 
variable-length, bidirectional, discrete, self-checking, 
alphanumeric code. Three of the nine elements are 
wide and six are narrow. It is the standard for 
LOGMARS (the Department of Defense) and the AIAG. 


Code128. A bar code symbology characterized by a 
variable-length, alphanumeric code with 128 characters. 


Codabar. A bar code symbology characterized by a 
discrete, self-checking, numeric code with each 
character represented by a standalone group or four 
bars and three spaces between them. 


coded font. (1) A resource containing elements of a 
code page and a font character set, used for presenting 
text, graphics character strings, and bar code HRI. See 
also code page and font character set. (2) In FOCA, a 
resource containing the resource names of a valid pair 
of font character set and code page resources. The 
graphic character set of the font character set must 
match the graphic character set of the code page for 
the coded font resource pair to be valid. (3) In the IPDS 
architecture, a raster font resource containing code 
points that are directly paired to font metrics and the 
raster representation of character shapes, for a specific 
graphic character set. (4) In the IPDS architecture, a 
font resource containing descriptive information, a code 
page, font metrics, and a digital-technology 
representation of character shapes for a specific graphic 
character set. 


Coded Graphic Character Set Global Identifier 
(CGCSGID). A four-byte binary or a ten-digit decimal 
identifier consisting of the concatenation of a GCSGID 
and a CPGID. The CGCSGID identifies the code point 
assignments in the code page for a specific graphic 
character set, from among all the graphic characters 
that are assigned in the code page. 


color attribute. An attribute that affects the color 

values provided in a graphics primitive, a text control 
sequence, or an IPDS command. Examples of color 
attributes are foreground color and background color. 


color model. The method by which a color is 
specified. For example, the RGB color space specifies 
color in terms of three intensities for red (R), green (G), 
and blue (B). 


command. A request for performance of an operation 
or execution of a program. In Page Printer Formatting 
Aid, commands are control statements for major 
formatting functions. For example, FORMDEF and 
COPYGROUP are commands. Commands are further 
specified by subcommands and parameters. 


command stream. The sequence of Page Printer 
Formatting Aid commands that is submitted with the job 
control statements in a Page Printer Formatting Aid 


Glossary 463 


execution. The commands and subcommands are the 
control statements that define the object or objects to be 
generated. 


compatibility mode. Use of Table Reference 
Characters (TRCs) that are acceptable to line printers 
and page printers and that access page definitions with 
little or no change to the user’s data or to the job 
command stream. Contrast with page mode. 


composed-text data file. A file containing text data 
and text control information that dictates the format, 
placement, and appearance of the data to be printed. 


conditional processing. A page definition function 
that allows input data records to partially control their 
own formatting. 


construct. An architected set of data such as a 
structured field or a triplet. 


control character. (1) A character that denotes the 
start, modification, or end of a control function. A control 
character can be recorded for use in a subsequent 
action, and it can have a graphic representation. See 


also[character (2) A control function the coded 


representation of which consists of a single code point. 


copy group. A subset of a form definition containing a 
set of controls for the physical pages of a printout. Such 
functions as the selection of either of two paper sources 
on the page printer, the use of duplex printing, or the 
positioning of the reference point for all printing on the 
sheet are available in the copy group. 


cm. Centimeters. 
CMS. Conversational Monitor System. 
cpi. Characters per inch. 


cut-sheet media. Unconnected sheets. Contrast with 
continuous-form media. 


D 


data map. An internal object whose structured fields 
control the formatting of data on a logical page of a 
printout. Created by a PAGEDEF command or a 
PAGEFORMAT command. 


data stream. Acontinuous stream of data that has a 
defined format. An example of a defined format is a 
structured field. 


DBCS. Double-byte character set. 


default. Pertaining to an attribute, value, or option that 
is assumed when none is explicitly specified and one is 
needed to continue processing. 
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density. The number of characters per inch (cpi) in a 
bar code symbology. In most cases, the range is three 
to ten cpi. 


descender. Ina font, the distance from the baseline to 
the bottom of the character box. This value may differ 
for different characters in a given font. Contrast with 
ascender. 


direction. The print position of data in a logical page, 
line, or field. In Page Printer Formatting Aid, the ultimate 
reference point for all direction controls on a page is the 
hardware origin. Secondary and tertiary reference points 
are possible as well, allowing more than one print 
direction on a page. 


document. (1) A machine-readable collection of one or 
more objects that represents a composition, a work, or 
a collection of data. (2) A publication or other written 
material. 


double-byte character set (DBCS). A character set, 
such as a set of Japanese ideographs, requiring two 
bytes to identify each character. 


duplex printing. Printing on both sides of a sheet. 


E 


EAN. See European Article Numbering. 


EAN2SUP. A parameter that specifies a bar code type 
of European Article Numbering, Two-digit Supplemental. 


EAN5SUB. A parameter that specifies a bar code type 
of European Article Numbering, Five-digit Supplemental. 


EAN8. A parameter that specifies a bar code type of 
European Article Numbering 8 (includes Japanese 
Article Numbering-short). 


EAN13. A parameter that specifies a bar code type of 
European Article Numbering 13 (includes Japanese 
Article Numbering-standard). 


EBCDIC. See Extended Binary-Coded Decimal 
Interchange Code. 


electronic overlay. In IBM Print Server Facility, a 
collection of constant data that are electronically 
composed in the host processor and can be merged 
with variable data on a sheet during printing. Contrast 
with page segment. See also overlay, preprinted form. 


European Article Numbering (EAN). The bar code 
symbology used to code grocery items in Europe. 


Extended Binary-Coded Decimal Interchange Code 
(EBCDIC). A coded character set that consists of 
eight-bit coded characters. 


external library resource (member). Objects that can 
be used by other program products while running print 


jobs; for example, coded fonts, code pages, font 
character sets, form definitions, page definitions, and 
page segments. Synonym for resource object. 


external object. Synonym for resource object. 


F 


FCB. Forms control buffer. 


field. (1) In a record, a specified area used for a 
particular class of data; for example, a group of 
character positions used to enter or display wage rates 
on a screen. (2) In Page Printer Formatting Aid, any 
area of a record singled out for particular formatting 
treatment. 


field processing. Mapping individual fields to a page 
of output with special formatting controls. 


file. A named set of records stored or processed as a 
unit. (T) 


fixed medium information. Information that can be 
applied to a sheet by a printer or printer-attached device 
that is independent of data provided through the data 
stream. Fixed medium information does not mix with the 
data provided by the data stream and is presented on a 
sheet either before or after the text, image, graphics, or 
bar code data provided within the data stream. Fixed 
medium information can be used to create “pre-printed 
forms”, or other types of printing, such as colored logos 
or letterheads, that cannot be created conveniently 
within the data stream. 


FOCA. See Font Object Content Architecture. 


font. A family or assortment of characters of a given 
size and style; for example, 9-point Bodoni Modern. (A) 


font character set. A FOCA resource containing 

descriptive information, font metrics, and the digital 
representation of character shapes for a specified 

graphic character set. 


Font Object Content Architecture (FOCA). An 
architected collection of constructs used to describe 
fonts and to interchange those font descriptions. 


Font Typeface Global Identifier (FGID). See global 
resource identifier (GRID). 


form. A physical piece of paper or other medium on 
which output data is printed. For cut-sheet printers, a 
form is one sheet of paper or other medium. For 
continuous-forms printers, the form is the area of paper 
(or other medium) defined to the printer as a single 
physical page, which for fan-fold paper is normally the 
area between perforations. See also medium, sheet, 
and page. 


format. The arrangement or layout of data on a 
physical medium or in a presentation space. 


formatted data. In FD:OCA, data whose implied 
syntax and semantics are represented by architected 
controls that accompany the data. 


formatted data object (FDO). An object that contains 
formatted data. See also object. 


Formatted Data Object Content Architecture 
(FD:OCA). An architected collection of constructs used 
to interchange formatted data. 


formatter. A process used to prepare a document for 
presentation. 


Formdef. See Form Definition. 


form definition. In IBM Print Server Facility, a 
resource object that defines the characteristics of the 
form, which include: overlays to be used, text 
suppression, position of page data on the form, and 
modifications and number of copies of a page. 


forms control buffer (FCB). A line printer control. In 
the 3800 Printing Subsystem, a buffer for controlling the 
vertical format of printed output. 


forms flash. (1) In the 3800 Printing Subsystem, the 
function of the printer that allows user-prepared images 
to be printed with variable page data. An operator must 
insert the desired image holder when forms overlay 
printing is desired. (2) The photographic negative of a 
predefined design to be exposed to the photoconductor 
by a flash of light. The forms overlay can be merged 
with variable data during printing. See also electronic 
overlay. 


G 


GCGID. See Graphic Character Global Identifier. 
GCSGID. See Graphic Character Set Global Identifier. 
GID. See global identifier. 


Global Identifier (GID). Any of the following: 

* Code Page Global ID (CPGID) 

* Graphic Character Global Identifier (GCGID) 

¢ Font Typeface Global Identifier (FGID) 

* Graphic Character Set Global Identifier (GCSGID) 


¢ Coded Graphic Character Set Global Identifier 
(CGCSGID) 


* In MO:DCA, an encoded graphic character string that 
provides a reference name for a document element. 


* Global Resource Identifier (GRID) 

* Object Identifier (OID) 

* Coded Character Set Identifier (CCSID). 

global resource identifier (GRID). An eight-byte 


identifier that identifies a coded font resource. A GRID 
contains the following fields in the order shown: 


Glossary 465 


1. GCSGID of a minimum set of graphic characters 
required for presentation. It can be a character set 
that is associated with the code page, or with the 
font character set, or with both. 


2. CPGID of the associated code page 
3. FGID of the associated font character set 
4. Font width in 1440ths of an inch. 


GOCA. See Graphics Object Content Architecture. 


graphic character. A member of a set of symbols that 
represent data. Graphic characters can be letters, digits, 
punctuation marks, or other symbols. Synonymous with 
glyph. See also character. 


Graphic Character Global Identifier (GCGID). An 
alphanumeric character string used to identify a specific 
graphic character. A GCGID can be from four-bytes to 
eight-bytes long. 


graphic character identifier. The unique name for a 
graphic character in a font or in a graphic character set. 
See also character identifier. 


Graphic Character Set Global Identifier (GCSGID). 
A unique graphic character set identifier that can be 
expressed as either a two-byte binary or a five-digit 
decimal value. 


graphics command set. In the IPDS architecture, a 
collection of commands used to present GOCA data in 
a page, page segment, or overlay. 


graphics object. An object that contains graphics 
data. See also object. 


graphics object area. A rectangular area on a logical 
page into which a graphics presentation space window 
is mapped. 


Graphics Object Content Architecture (GOCA). An 
architected collection of constructs used to interchange 
and present graphics data. 


GRID. See global resource identifier. 


guard bars. The bars at both ends and the center of 
an EAN, JAN, or|UPC}symbol, that provide reference 
points for scanning. 


H 


height. (1) In Page Printer Formatting Aid, refers to 
the vertical dimension of a logical page and is controlled 
by the HEIGHT subcommand. (2) In bar codes, the bar 
dimension perpendicular to the bar width. Synonymous 
with bar height and bar length. 


hexadecimal. A number system with a base of 

sixteen. The decimal digits 0 through 9 and characters 
A through F are used to represent hexadecimal digits. 
The hexadecimal digits A through F correspond to the 
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decimal numbers 10 through 15, respectively. An 
example of a hexadecimal number is X'1B', which is 
equal to the decimal number 27. 


highlighting. The emphasis of displayed or printed 
information. Examples are increased intensity of 
selected characters on a display screen and exception 
highlighting on an IPDS printer. 


host. (1) In the}IPDS|architecture, a computer that 
drives a printer. (2) In/IOCA| the host is the controlling 
environment. 


HRI. See|human-readable interpretation 
human-readable interpretation (HRI). The printed 
translation of|bar code|characterp into equivalent Latin 


alphabetic characters, Arabic numeral decimal digits, 


and common special characters normally used for 
printed human communication. 


image. An electronic representation of a picture 
produced by means of sensing light, sound, electron 
radiation, or other emanations coming from the picture 
or reflected by the picture. An image can also be 
generated directly by software without reference to an 
existing picture. 


image content. [Image] data and its associated image 
data parameters. 


Image Object Content Architecture (IOCA). An 
architected collection of[constructf used to interchange 
and present|images| 


in. Inches. 


IND2OF5. A parameter that specifies a bar code type 
of Industrial 2-of-5. 


Infoprint. A solution of software and hardware 
products that can supplement or replace the offset 
presses and copiers in print shops with high-quality, 
non-impact, black and white or process color printers. 
Infoprint takes documents from creation to the final 
product. 


Infoprint Manager for AIX or Windows NT/2000. A 
software component of IBM Infoprint. IBM Infoprint 
Manager for AIX or Windows NT/2000 handles the 
scheduling, archiving, retrieving, and assembly of a print 
job and its related resource files. It also tracks the 
finishing and packaging of the printed product. 


inline. In printing, the direction of successive 
characters in a line of text. Synonymous with inline 
direction. 


inline direction. Synonym for inline. 


Intelligent Printer Data Stream (IPDS). An 
architected [host}to-printer data stream that contains 
both data and controls defining how the data is to be 
presented. 


International Organization for Standardization 
(ISO). An organization of national standards bodies 
from various countries established to promote 
development of standards to facilitate international 
exchange of goods and services, and develop 
cooperation in intellectual, scientific, technological, and 
economic activity. 


Invoke Data Map. A control record placed in the 
user’s data to begin a new page format. 


Invoke Medium Map. A control record placed in the 
user’s data to begin a new copy group. 


IOCA. See Image Object Content Architecture. 
IPDS. See Intelligent Printer Data Stream. 


ISO. See International Organization for 
Standardization. 


italics. A typeface with characters that slant upward to 
the right. In FOCA, italics is the common name for the 
defined inclined typeface posture attribute or parameter. 


ITL2OF5. A parameter that specifies a bar code type 
of Interleaved 2-of-5, Automatic Identification 
Manufacturers Uniform Symbol Specification-| 2/5. 


J 


JAN. See Japanese Article Numbering. 


Japanese Article Numbering (JAN). The bar code 
symbology used to code grocery items in Japan. 


jog. Offset stacking of individual sheets or sets of 
sheets in the output hopper of a page printer or copy 
mark in a continuous forms printer. 


K 


kanji. A graphic character set consisting of symbols 
used in Japanese ideographic alphabets. Each 
character is represented by 2 bytes. 


keyword. A two-part self-defining parameter consisting 
of a one-byte identifier and a one-byte value. 


L 


landscape presentation. The position of a printed 
sheet that has its long edges at the top and bottom and 
its short edges at the sides. Contrast with portrait 
presentation. 


language. A set of symbols, conventions, and rules 
that is used for conveying information. 


leading. A printer's term for the distance between lines 
of type measured in points. It refers to the lead slug 
placed between lines of type in traditional typesetting. 


library. System storage for generated form definitions 
and page definitions. 


library resource (member). A named collection of 
records or statements in a library. 


library resource name. A name by which an object 
may be called from a library by IBM Print Server Facility 
as part of a print job. Includes the two-character prefix 
for the type of object, such as P1 for page definitions, 
F1 for form definitions, or O1 for overlays (also known 
as resource name). 


line attributes. Those attributes that pertain to straight 
and curved lines. Examples of line attributes are line 
type and line width. 


line data files. Files formatted for printing on line 
printers. 


line printer. A device that prints a line of characters as 
a unit. (I) (A) Synonymous with /ine-at-a-time printer. 
Contrast with page printer. 


line type. A line attribute that controls the appearance 
of a line. Examples of line types are dashed, dotted, 
and solid. Contrast with line width. 


line width. A line attribute that controls the 
appearance of a line. Examples of line width are light, 
medium, and bold. Contract with /ine type. 


lines per inch (Ipi). (1) On a printer, a measurement 
of the number of lines per vertical inch of paper. (2) A 
unit of measure for specifying the baseline increment. 


local name. A name for a suppression, an overlay, or 
a font that is used only within the Page Printer 
Formatting Aid command stream. Contrast with 
user-access name. 


location. A site within a data stream. A location is 
specified in terms of an offset in the number of 
structured fields from the beginning of a data stream, or 
in the number of bytes from another location within the 
data stream. 


logical page. (1) The area on a surface of a form that 
is formatted for printing. (2) A collection of data that can 
be printed on one side of a sheet of paper. See also 
form and page. 


logical page origin. (1) The user-defined point that 
acts as a reference for all positioning of printed material 
on the page. (2) The point nearest the hardware origin 
where printing can occur. 
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Logical unit (L-unit). A unit of linear measurement 
expressed with a unit base and units per unit-base 
value. For example , in Page Printer Formatting Aid, 1 
logical unit = 1/240 inch (unit base = 10 inches, units 
per unit base = 2400). 


Ipi. Lines per inch. 


lowercase. Pertaining to small letters as distinguished 
from capital letters. Examples of small letters are a, b, 
and g. Contrast watifupoersse 

L-unit. A unit of linear measurement expressed with a 
unit base and units per unit-base value. In other words, 


the number of units in a linear inch. Synonymous with 
logical unit. 


M 


MAT2OF5. A parameter that specifies a bar code type 
of Matrix 2-of-5. 


media origin. The first hardware addressable point on 
the physical page. The point from which the logical 
page origin is positioned by the medium map. 


medium. The physical material (for example, paper) 
on which data is printed. See also form. 


medium map. An internal object whose structured 
fields control the physical sheets of a printout, including 
the choice of duplex printing, the beginning print 
position, and the paper source to use. Controlled by a 
COPYGROUP command in a Page Printer Formatting 
Aid command stream. 


medium overlay. Synonym for overlay. 


mixed data files. Files consisting of composed and 
uncomposed portions. 


mm. Millimeters. 


MOD. A parameter that specifies additional processing 
information about the bar code symbol to be generated. 
Refer to Data Stream and Object Architecture: Bar 
Code Object Content Architecture Reference 
(S544-3766) for more information. 


Mixed Object Document Content Architecture 
(MO:DCA). (1) An architected, device-independent 
data stream for interchanging documents. (2) Print data 
that has been composed into pages. Text formatting 
programs can produce composed text data consisting 
entirely of structured fields. 


MO:DCA. See Mixed Object Document Content 
Architecture. 


MO:DCA-P. Mixed Object Document Content 
Architecture for Presentation. 
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module. Ina bar code symbology, the nominal width 
of the smallest element of a[bar|or space. Actual bar 
code symbology bars and spaces can be a single 
module wide or some multiple of the module width. The 
multiple need not be an integer. 


MODWIDTH. A parameter that specifies the width of 
the smallest defined bar code element, using mils 
(thousandths of an inch). 


MSI. A parameter that specifies a bar code type of 
modified Plessey code. 


multiple up. The printing of more than one page ona 
single side of a sheet of paper. 


MVS or OS/390. Multiple Virtual Storage. (Changed to 
OS/390). 


N 


name. A table heading for architecture syntax. The 
entries under this heading are short names that give a 
general indication of the contents of the construct. 


noncompatibility mode. The use of table reference 
character (TRC) numbers not compatible with a line 
printer. 


normal duplex printing. Duplex printing for sheets 
that are to be bound on the long edge of the paper, 
regardless of whether the printing is portrait or 
landscape. Contrast with tumble duplex printing. 


N_UP. The printing of more than one logical page ona 
single side of a medium. 


O 


object. A collection of data referred to by a single 
name. Form definitions and page definitions stored in a 
library are resources. 


offset. A table heading for architecture syntax. The 
entries under this heading indicate the numeric 
displacement into a construct. The offset is measured in 
bytes and starts with byte zero. Individual bits can be 
expressed as displacements within bytes. 


order. In GOCA, a graphics construct that the 
controlling environment builds to instruct a drawing 
processor about what to draw and how to draw it. 


orientation. The angular distance a presentation 
space or object area is rotated in a specified coordinate 
system, expressed in degrees and minutes. For 
example, the orientation of printing on a physical 
medium, relative to the X,, axis of the X,,,Y,, coordinate 
system. 


origin. A picture element (pel) 


outline font. A shape technology in which the graphic 
character shapes are represented in digital form by a 
series of mathematical expressions that define the outer 
edges of the strokes. The resultant graphic character 
shapes can be either solid or hollow. 


overlay. A collection of predefined data such as lines, 
shading, text, boxes, bar codes, or logos, that can be 
merged with variable data on a page during printing. 
See electronic overlay. 


Overlay Generation Language (OGL). A 
programming language used to produce electronic 
overlays. 


P 


page. (1) Acollection of data that can be printed on 
one side of a sheet of paper or a form. (2) The 
boundary for determining the limits of printing. See also 
logical page and physical page. 


page definition. A resource containing a set of Page 
Printer Formatting Aid formatting controls for printing 
pages of data. Includes controls for number of lines per 
printed sheet, font selection, print direction, and 
mapping of individual fields in the data to positions on 
the printed sheets. 


page ejection. The point at which the printer finishes 
printing on one sheet and moves to the beginning of the 
next sheet. 


page format. A subset of a page definition, containing 
all the same controls for formatting printed output as a 
page definition. Includes controls for number of lines per 
printed sheet, font selection, print direction, and 
mapping of individual fields in the data to positions on 
the printed sheets. 


page mode. The mode of operation in which an AFP 
printer can accept a page of data from a host processor 
to be printed on an all-points-addressable output 
medium. Printed data can consist of pages composed of 
text, images, overlays, and page segments. Contrast 
with compatibility mode. 


page printer. A device that prints a page at a time. 
Contrast with line printer. 


Page Printer Formatting Aid for AIX (Page Printer 
Formatting Aid). An IBM licensed program that allows 
you to create and store form definitions and page 
definitions, which are resource objects for print-job 
management. By writing a command stream specifying 
form definitions, page definitions, or both, for executing 
Page Printer Formatting Aid, you can store the objects 
specified in the library. These objects can then be used 
to format printed output. 


page segment. (1) An object that can contain text and 
images and be included at any addressable point on a 


page or electronic overlay. It assumes the environment 
of an object it is included in. (2) A library resource that 
contains the definition of a page segment. Contrast with 
electronic overlay. 


parameter. (1) A variable that is given a constant 
value for a specified application and that may denote 
the application. (I) (A) (2) In Page Printer Formatting 
Aid, the values specified for a subcommand. 


partition. (1) Dividing the medium presentation space 
into a specified number of equal-sized areas in a 
manner determined by the current physical media. (2) In 
FD:OCA, a conceptual subdivision of a string of data 
fields. A partition can be further divided into 
subpartitions. 


pel. Picture element. The smallest printable or 
displayable unit on a physical medium. In computer 
graphics, the smallest element of a physical medium 
that can be independently assigned color and intensity. 
Synonymous with picture element and pixel. 


PELS. In Page Printer Formatting Aid, a unit of 
measure under the SETUNITS command. See also 
logical unit. 


physical page. A single surface (front or back) of a 
sheet. See also form and page. 


picture element. (1) In computer graphics, the 
smallest element of a display space that can be 
independently assigned color and intensity. (T) (2) The 
smallest area that can be individually toned by the 
printer. 


pixel. The smallest printable or displayable unit on a 
physical medium. Synonymous with pel and picture 
element. 


PMF. Print Management Facility 


point. In printing, a unit of about 1/72 of an inch used 
in measuring typographical material, for example: 
10-point Helvetica. There are 12 points to a pica. 


portrait presentation. The position of a printed sheet 
that has its short edges at the top and bottom and its 
long edges at the sides. Contrast with landscape 
presentation. 


position. The location specified for a line or field on 
the output page. 


POSTNET. A parameter that specifies a bar code type 
of POSTal Numberic Encoding Technique (United States 
Postal Service), and defines specific values for the BSD 
module width, element height, height multiplier, and 
wide-to-narrow ratio fields. 


PPFA. Page Printer Formatting Aid. 


preprinted form. A sheet of paper containing a 
preprinted design of constant data. Variable data can be 
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merged with the constant data on such a form. See also 
electronic overlay, forms flash. 


print line. A single line of text. In the formatting of line 
data, it refers to the output generated by one data 
record. Governed by the PRINTLINE command. 


Print Management Facility (PMF). A program that 
can create fonts, segments, page definitions, and form 
definitions. 


Print Server Facility (PSF). A program that produces 
printer commands from the data sent to it. 


printer—attached device. Either a preprocessor or 
postprocessor attached to the printer. 


PSF. Print Server Facility. 


R 


range. A table heading for architecture syntax. The 
entries under this heading give numeric ranges 
applicable to a construct. The ranges can be expressed 
in binary, decimal, or hexadecimal. The range can 
consist of a single value. 


raster. (1) In computer graphics, a predetermined 
pattern of lines that provides uniform coverage of a 
display space. (T) (2) In AFP printers, an on-or-off 
pattern of electrostatic images produced by the laser 
print head. 


RASTER / NORASTER subcommand. A 
subcommand that specifies whether an overlay is to be 
kept in the printer (3800 only) as raster data. 


RATIO. A parameter that specifies the ratio of the 
wide-element dimension to the narrow-element 
dimension whenever two different size elements exist. 


ratio. The relationship in quantity, amount, or size 
between two or more things. 


record. (1) In programming languages, an aggregate 
that consists of data objects, possibly with different 
attributes, that usually have identifiers attached to them. 
In some programming languages, records are called 
structures. (I) (2) A set of data treated as a unit. (T) (3) 
A set of one or more related data items grouped for 
processing. 


RM4SCC. A parameter that specifies a 4-state 
customer code defined by the Royal Mail Postal Service 
of England for bar coding postal code information. See 
Royal Mail 4 State Customer Code. 


resource. A collection of printing instructions, and 
sometimes data to be printed, that consists entirely of 
structured fields. A resource object is stored as a 
member of a library and can be called for by IBM Print 
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Server Facility when needed. The different resource 
objects are: page segments, overlays, form definitions, 
and page definitions. 


RNORMAL. Rotated normal. A Page Printer 
Formatting Aid parameter that specifies the type of 
duplex printing. It means the tops of both sides of a 
duplex-printed sheet are toward the same physical edge 
of the sheet, for side binding of the document. Used 
with landscape-presentation pages. 


rotation. The orientation of the characters of a font 
with respect to the baseline. 


Royal Mail 4 State Customer Code (RM4SCC). A 
two-dimensional bar code symbology developed by the 
United Kingdom’s Royal Mail postal service for use in 
automated mail-sorting processes. 


RTUMBLE. Rotated tumble. A Page Printer Formatting 
Aid parameter that specifies a type of duplex printing. It 
means the top of one side of a duplex-printed sheet and 
the bottom of the other are toward one physical edge of 
the sheet, for top binding of the document. Used with 
landscape-presentation pages. 


rule. A solid line of any line width. 


S 


SBCS. Single-byte character set. 


scanner. In bar codes, an electronic device that 
converts optical information into electrical signals. 
Sometimes called a reader or decoder. 


segment. (1) Acollection of composed text and 
images, prepared before formatting and included in a 
document when it is printed. See page segment. (2) 
The resource that contains the structured-field definition 
of a page segment. 


sheet. A single piece of paper. For cut-sheet printers, 
a synonym for form. 


shift-in and shift-out characters (SOSI). Characters 
used to delimit literals in Page Printer Formatting Aid 
command streams: X'0E' and X'OF'. 


simplex printing. A method used to print data on one 
side of a sheet; the other side is left blank. Contrast 
with duplex printing. 


single-byte character set. A character set whose 
codes require a single byte of data. The character set 
used for English is an example. 


skip-to-channel control. A line printer control 
appearing in line data. Allows space to be left between 
print lines. Compatible with page printers when the data 
is formatted by page definitions. 


space. In bar codes, the lighter element of a printed 
bar code symbol, usually formed by the background 
between bars. 


space width. In bar codes, the thickness of a bar 
code symbol space measured from the edge closest to 
the symbol start character to the trailing edge of the 
same space. 


SSASTERISK. A parameter that specifies whether an 
asterisk is to be generated as the HRI for CODE39 bar 
code start and stop characters. 


start-stop character or pattern. In bar codes, a 
special bar code character that provides the scanner 
with start and stop reading instructions as well as a 
scanning direction indicator. The start character is 
normally at the left end and the stop character at the 
right end of a horizontally-oriented bar code symbol. 


structured field. A self-identifying string of bytes and 
its data or parameters. 


subcommand. (1) In Page Printer Formatting Aid, the 
next level of control below commands. (2) A request for 
an operation that is within the scope of work requested 
by a previously issued command. 


subgroup. A subset of a form definition that is used to 
reprint the same page of data more than once. 
Subgroups provide for variations in the same page of 
data within one print job. Modifications that distinguish 
one subgroup from another are number of copies, type 
of duplex printing, inclusion of overlays, inclusion of 
suppressions, and (only for the 3800 printer) forms 
flash. A set of modifications within a copy group that 
applies to a certain number of copies of a form. A copy 
group can contain more than one subgroup. 


subpage. A part of a logical page on which line data 
may be placed. In the page definition, multiple 
subpages can be placed on a physical page based on 
changes in the print data. 


suppression. The electronic equivalent of a spot 
carbon, preventing selected data from being printed on 
certain copies. 


symbology. A bar code language. Bar code 
symbologies are defined and controlled by various 
industry groups and standards organizations. Bar code 
symbologies are described in public domain bar code 
specification documents. Synonymous with bar code 
symbology. See also Canadian Grocery Product Code 
(CGPC), European Article Numbering (EAN), Japanese 
Article Numbering (JAN), and Universal Product Code 
(UPC). 


syntax. The rules governing the structure of a 
construct. 


T 


table reference character (TRC). Usually, the second 
byte on a line in the user’s data. This byte contains a 
value (0 - 126) that is used to select a font to be used 
to print that line. 


tate. The Japanese word for top-to-bottom, as applied 
to the formatting of writing and printing. The traditional 
arrangement of Japanese kanji characters on the page. 
Pronounced fa-tay. 


text. A graphic representation of information on an 
output medium. Text can consist of alphanumeric 
characters and symbols arranged in paragraphs, tables, 
columns, and other shapes. 


TRC. Table reference character. 


truncation. Planned or unplanned end of a 
presentation space or data presentation. 


tumble duplex printing. Duplex printing for sheets 
that are to be bound on the top, as is often done for 
legal documents. The top of one side of each sheet is 
at the same edge as the bottom of the other side. 
Contrast with normal duplex printing. 


triplet. A three-part self-defining variable-length 
parameter consisting of a length byte, an identifier byte, 
and one or more parameter-value bytes. 


type. A table heading for architecture syntax. The 
entries under this heading indicate the types of data 
present in a construct. Examples include: BITS, 
CHARCODE, SBIN, UBIN, UNDF. 


TYPE. A parameter that specifies the kind of bar code 
symbol to be generated. For example, CODE39, MSI, 
UPCA, UPCE, and so on. 


type font. See font. 


type weight. A parameter indicating the degree of 
boldness of a typeface. A character’s stroke thickness 
determines its type weight. Examples are light, medium 
and bold. 


type width. A parameter indicating a relative change 
from the font’s normal width-to-height ratio. Examples 
are normal, condensed and expanded. 


U 


unformatted print data. Data that is not formatted for 
printing. A page definition can contain controls that map 
unformatted print data to its output format. 


Uniform Symbol Specification (USS). A series of [bar] 
pedis symbology symbology|specifications published by AIM; 
currently included are USS-Interleaved 2 of 5,|USS-39} 
USS-93, USS-Codabar, and|USS-128) 
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Universal Character Set (USC). A printer feature that 
permits the use of a variety of character arrays. 
Synonymous with font. 


Universal Product Code (UPC). A standard[bar code] 
symbology! commonly used to mark the price of items in 
stores, that can be read and interpreted by a computer. 


unprintable area. The area of a sheet of paper on 
which no printing can be done because of printer and 
hardware limitations. 


UPC. See}Universal Product Code 


UPCA. A parameter that specifies a bar code type of 
Universal Product Code (United States) and the 
Canadian Grocery Product Code, Version A. 


UPCE. A parameter that specifies a bar code type of 
Universal Product Code (United States) and the 
Canadian Grocery Product Code, Version E. 


UPC2SUPP. A parameter that specifies a bar code 
type of Universal Product Code (United States) two-digit 
Supplemental (periodicals). 


UPC5SUPP. A parameter that specifies a bar code 
type of Universal Product Code (United States) five-digit 
Supplemental (paperbacks). 


uppercase. Pertaining to capital letters. Examples of 
capital letters are A, B, and C. Contrast witiflowereaed 


user-access name. The library resource name of a 
font or an overlay, less its two-character prefix. Contrast 


USS. See|Uniform Symbol Specification 


W 


width. In Page Printer Formatting Aid, refers to the 
horizontal dimension of a logical page, is specified in 
the page definition, and is controlled by the WIDTH 
subcommand. 


X 


x-coordinate. The horizontal or inline position that 
defines a page origin or the starting point of a line or 
field. 


Y 


y-coordinate. The vertical or baseline position that 
defines a page origin or the starting point of a line or 
field. 
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BCOCA 


The following publication contains information 
about bar code concepts related to the PPFA 


BARCODE subcommand: 


Publication Order 
Number 
Data Stream and Object Architectures: $544-3766 


Bar Code Object Content Architecture 
Reference 


OS/400 
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IBM Advanced Function Presentation: $544-5368 
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OS/390 Infoprint Server Operation and $544-5693 

Administration 
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Publication Order 
Number 

Print Services Facility/VSE: Application $544—3666 
Programming Guide 

Print Services Facility/VSE: System $544-3665 
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BIN subcommand 
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for PAGEDEF command (record format) 341 
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for PAGEDEF command (XML) 341 
for PAGEFORMAT command (record 
format) 346 
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for PAGEFORMAT command (XML) 346 
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for PAGEFORMAT command (record 

format) 349 
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OB2ID subcommand 
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for OBJECT command (XML) 338 
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for PAGEFORMAT command (record format) 346 
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row-size, BCXPARMS SIZE (continued) 
BARCODE subcommand (continued) 
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RGB subcommand 
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for FIELD command (traditional) 228 
for FIELD command (XML) 312 
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unit (continued) 
HEIGHT subcommand (continued) 
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format) 346 
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for PAGEFORMAT command (record 
format) 346 
for PAGEFORMAT command (traditional) 242 
for PAGEFORMAT command (XML) 346 
unit CM 
LINESP subcommand 
for SETUNITS command (traditional) 260 
unit IN 
LINESP subcommand 
for SETUNITS command (traditional) 260 
unit LPI 
LINESP subcommand 
for SETUNITS command (traditional) 260 
unit MM 
LINESP subcommand 
for SETUNITS command (traditional) 260 
unit PELS 
LINESP subcommand 
for SETUNITS command (traditional) 260 
unit POINTS 
LINESP subcommand 
for SETUNITS command (traditional) 260 
unit, OBSIZE 
OBJECT subcommand 
for LAYOUT command (record format) 329 
for PRINTLINE command (traditional) 253 
for XLAYOUT command (XML) 358 
verificationID 
VFYSETUP subcommand 
for FORMDEF command 199 
vert subcommand 
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for DRAWGRAPHIC - ELLIPSE command 
(XML) 284 
vertical position x-pos 
POSITION subcommand 
for PRINTLINE command (traditional) 248 
vertical position 
POSITION subcommand 
for PRINTLINE command (traditional) 248 
for XLAYOUT command (XML) 357 
PRINTDATA subcommand 
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Xname unquoted-name with no data tag (continued) 
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y-pos, vertical position y-pos 
POSITION subcommand 
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for OBJECT command (XML) 338 
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2DMATRIX, TYPE 
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2DMAXI 395, 402, 410, 413 
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2DPDF417 395, 402, 410, 413 
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A‘quoted-name', Xname 
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ABOVE, HRI 
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for FIELD command (record format) 294 
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with XLAYOUT command (XML) 353 
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format) 346 
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format) 277 
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AIX 
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for DRAWGRAPHIC - BOX command (XML) 275 
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Appendix A 
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for DRAWGRAPHIC - ELLIPSE command 
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AXIS2 
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BARCODE subcommand (continued) 
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BCXPARMS ID uidLo 

for FIELD command (record format) 296 
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BARCODE subcommand (continued) 
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BARCODE subcommand (continued) 
HRI ABOVE (continued) 
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BARCODE subcommand (continued) 

TYPE 2DPDF417 
for FIELD command (record format) 293 
for FIELD command (traditional) 225 
for FIELD command (XML) 309 

TYPE APOSTAL 
for FIELD command (record format) 294 
for FIELD command (traditional) 225 
for FIELD command (XML) 310 
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for FIELD command (record format) 292 
for FIELD command (traditional) 224 
for FIELD command (XML) 308 
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for DRAWGRAPHIC - BOX command (record 
format) 274 
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for DRAWGRAPHIC - LINE command 
(XML) 277 
double-byte code characters (type G text) 
for FIELD command (record format) 287 
for FIELD command (traditional) 219 
for FIELD command (XML) 302 
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FIELD command (record format) 
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UP 289 

double-byte code characters (type G text) 

FLDNUM subcommand 288 

hexadecimal codes (type X text) 287 

HIGHLIGHT subcommand 290 

kanji numbers (type K text) 287 

LENGTH nsubcommand 287 

PAGENUM nsubcommand 288 

POSITION subcommand 288 
X-pos* 289 
X-pos— 288 
X-pos X 288 
X-pos CURRENT 289 
y-pos* 289 
y-pos— 289 
y-pos y 289 
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POSITION subcommand (continued) 
y-pos CURRENT 289 
y-pos NEXT 289 
RECID subcommand 288 
RGB subcommand 290 
bvalue 290 
gvalue 290 
rvalue 290 
single-byte code characters (type C text) 287 
START subcommand 286 
-—n 287 
+n 287 
* 286 
n 286 
subcommands 286 
SUPPRESSION subcommand 289 
name 289 
syntax diagram 285 
TEXT subcommand 287 
‘text 287 
duplication Dn 287 
L(m) 287 
texttype C 287 
texttype G 287 
texttype K 287 
texttype X 287 
two-dimensional barcode commands 295 


FIELD command (traditional) 


bvalue 
RGB subcommand 222 

gvalue 
RGB subcommand 222 

rvalue 
RGB subcommand 222 

BARCODE subcommand 223 
name 223 
BCOLOR cname 227 
BCXPARMS 227 
BCXPARMS E2A 228 
BCXPARMS ESC 229 
BCXPARMS FNC1IND 230 
BCXPARMS FNC1UCC 230 
BCXPARMS ID uidHi 228 
BCXPARMS ID uidLo 228 
BCXPARMS MAC5 230 
BCXPARMS MAC6 230 
BCXPARMS MACRO 231 
BCXPARMS MODE 230 
BCXPARMS NOE2A 229 
BCXPARMS NOESC 229 
BCXPARMS NOZIPPER 230 
BCXPARMS RDRPROG 230 
BCXPARMS SECLEV 230 
BCXPARMS SEQUENCE 228 
BCXPARMS SEQUENCE sqn 228 
BCXPARMS SEQUENCE fot 228 
BCXPARMS SEQUENCE OF 228 
BCXPARMS SIZE 228 
BCXPARMS SIZE num-rows 228 
BCXPARMS SIZE row-size 228 
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BARCODE subcommand (continued) 
BCXPARMS SIZE MIN 228 
BCXPARMS USERDEF 230 
BCXPARMS ZIPPER 231 
data matrix special functions 230 
HEIGHT n 227 
HEIGHT unit 227 
HRI ABOVE 226 
HRI BELOW 226 
HRI OFF 226 
HRI ON 226 
HRI ONLY 226 
HRIFONT fontname 226 
MOD n 225 
MODWIDTH unit 227 
RATIO n 227 
SSASTERISK OFF 226 
SSASTERISK ON 226 
SUPPBLANKS 227 
TYPE n 223 
TYPE type-name 223 
TYPE 2DMATRIX 225 
TYPE 2DMAXI 225 
TYPE 2DPDF417 225 
TYPE APOSTAL 225 
TYPE CDB20OF7 224 
TYPE CODE128 224 
TYPE CODE39 223 
TYPE EAN13 224 
TYPE EAN2SUP_ 224 
TYPE EAN5SUB 225 
TYPE EAN8 224 
TYPE IND2OF5 224 
TYPE ITL2OF5 224 
TYPE JPOSTAL 225 
TYPE MAT2OF5 224 
TYPE MSI 223 
TYPE POSTNET 225 
TYPE RM4SCC 225 
TYPE UPC2SUPP 224 
TYPE UPC5SUPP 224 
TYPE UPCA 223 
TYPE UPCE 224 
zipper pattern 230 

BLACK subcommand 222 

CIELAB subcommand 
civalue 223 
c2value 223 
Lvalue 223 

CMYK subcommand 
cvalue 222 
kvalue 222 
mvalue 222 
yvalue 222 

color model 
BLACK 222 
CIELAB 223 
CMYK 222 
COVERAGE 222 
HIGHLIGHT 222 
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FIELD command (traditional) (continued) 

color model (continued) 

RGB 222 
COLOR subcommand 221 

colorname 221 
COVERAGE subcommand 222 
DIRECTION subcommand 221 

ACROSS 221 

BACK 221 

DOWN 221 

UP 221 
double-byte code characters (type G text) 
FONT subcommand 220 

name1 220 

name2 220 
hexadecimal codes (type X text) 219 
HIGHLIGHT subcommand 222 
kanji numbers (type K text) 219 
LENGTH nsubcommand 219 
POSITION subcommand 220 

xX-pos* 220 

X-pos— 220 

X-pos X 220 

x-pos CURRENT 220 

y-pos* 221 

y-pos— 220 

y-pos y 220 

y-pos CURRENT 221 

y-pos NEXT 220 
RGB subcommand 222 

bvalue 222 

gvalue 222 

rvalue 222 
single-byte code characters (type C text) 
START subcommand 218 

-n 219 

+n 219 

* 218 

n 218 
subcommands 218 
SUPPRESSION subcommand 221 

name 221 
syntax diagram 217 
TEXT subcommand 219 

‘text 219 

duplication Dn 219 

L(m) 219 

texttype C 219 

texttype G 219 

texttype K 219 

texttype X 219 
two-dimensional barcode commands 227 

FIELD command (XML) 

bvalue 

RGB subcommand 306 
gvalue 

RGB subcommand 306 
rvalue 

RGB subcommand 306 
ALIGN subcommand 304 

LEFT 304 
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FIELD command (XML) (continued) 

ALIGN subcommand (continued) 
RIGHT 304 

ATTR subcommand 303 
aname_ 303 
LENGTH n_ 303 
START n_ 303 

BARCODE subcommand 307 
name 307 
BCCOLOR colorname 312 
BCXPARMS 312 
BCXPARMS E2A_ 313 
BCXPARMS ESC 314 
BCXPARMS FNC1IND 315 
BCXPARMS FNC1UCC 315 
BCXPARMS ID uidHi 313 
BCXPARMS ID uidLo 313 
BCXPARMS MAC5 315 
BCXPARMS MAC6 315 
BCXPARMS MACRO 315 
BCXPARMS MODE 314 
BCXPARMS NOE2A_ 314 
BCXPARMS NOESC_ 314 
BCXPARMS NOZIPPER- 315 
BCXPARMS RDRPROG_ 315 
BCXPARMS SECLEV 315 
BCXPARMS SEQUENCE 312 
BCXPARMS SEQUENCE sqn 312 
BCXPARMS SEQUENCE tot 313 
BCXPARMS SEQUENCE OF 313 
BCXPARMS SIZE 312 
BCXPARMS SIZE num-rows 312 
BCXPARMS SIZE row-size 312 
BCXPARMS SIZE MIN 312 
BCXPARMS USERDEF 315 
BCXPARMS ZIPPER 315 
data matrix special functions 315 
HEIGHT n 311 
HEIGHT unit 311 
HRI ABOVE 310 
HRI BELOW 310 
HRI OFF 310 
HRI ON 310 
HRI ONLY 310 
HRIFONT fontname 311 
MOD n_ 310 
MODWIDTH n_ 311 
RATIO 312 
SSASTERISK OFF 311 
SSASTERISK ON 311 
SUPPBLANKS 312 
TYPE n 307 
TYPE type-name 307 
TYPE 2DMATRIX 309 
TYPE 2DMAXI 309 
TYPE 2DPDF417 309 
TYPE APOSTAL 310 
TYPE CDB20F7 308 
TYPE CODE128 308 
TYPE CODE39 308 
TYPE EAN128 308 


FIELD command (XML) (continued) 
BARCODE subcommand (continued) 
TYPE EAN13 308 
TYPE EAN2SUP_ 309 
TYPE EAN5SUB_ 309 
TYPE EAN8 308 
TYPE IND2OF5 308 
TYPE ITL2OF5 308 
TYPE JPOSTAL 309 
TYPE MAT20F5_ 308 
TYPE MSI 308 
TYPE POSTNET 309 
TYPE RM4SCC_ 309 
TYPE UPC2SUPP_ 308 
TYPE UPC5SUPP 308 
TYPE UPCA 308 
TYPE UPCE 308 
zipper pattern 315 
BLACK subcommand 306 
CIELAB subcommand 
clvalue 306 
c2value 306 
Lvalue 306 
CMYK subcommand 
cvalue 306 
kvalue 306 
mvalue 306 
yvalue 306 
color model 
BLACK 306 
CIELAB 306 
CMYK 306 
COVERAGE 306 
HIGHLIGHT 306 
RGB 306 
COLOR subcommand 305 
colorname 305 
COVERAGE subcommand 306 
DIRECTION subcommand 305 
ACROSS 305 
BACK 305 
DOWN 305 
UP 305 
double-byte code characters (type G text) 302 
FLDNUM 303 
FONT subcommand 303 
hexadecimal codes (type X text) 302 
HIGHLIGHT subcommand 306 
kanji numbers (type K text) 302 
LENGTH nsubcommand 302 
PAGENUM n- 303 
POSITION subcommand 304 
X-position x pos 304 
x-position 304 
X-position* 304 
X-position APOS 304 
X-position CPOS 304 
X-position CURRENT 304 
x-position LPOS 304 
y position 304 
y position* 305 


FIELD command (XML) (continued) 
POSITION subcommand (continued) 
y position- 304 
y position y pos 304 
y position CURRENT 305 
y position LPOS 304 
y position NEXT 305 
RECID 303 
RGB subcommand 306 
bvalue 306 
gvalue 306 
rvalue 306 
single-byte code characters (type C text) 302 
STAG 303 
START subcommand- 301 
* 301 
—-n 302 
+n 302 
n 301 
subcommands 301 
SUPPRESSION name 305 
syntax diagram 300 
TEXT 302 
TEXT subcommand 
‘text 302 
duplication Dn 302 
L(m) 302 
texttype C 302 
texttype G 302 
texttype K 302 
texttype X 302 
two-dimensional barcode commands 312 
field processing 
combining data 115 
combining with overlay 109 
positioning fields 46, 73 
rule 72 
rules 45 
selection of fields 46, 73 
use of fixed text with 112 
fields, printing 
in two directions 52, 74 
FILL subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 275 
for DRAWGRAPHIC - BOX command (XML) 275 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
FILL, OBMAP 
OBJECT subcommand 
for PRINTLINE command (traditional) 255 
for XLAYOUT command (XML) 359 
FILL, OBSIZE 
OBJECT subcommand 
for LAYOUT command (record format) 330 
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FINISH subcommand 

finishing operation implementation notes 

with COPYGROUP command 178 
finishing operation nesting rules 

with COPYGROUP command 178 
for COPYGROUP command 174 
for FORMDEF command 190 
OPCOUNT 

for COPYGROUP command 176 
OPCOUNT n 

for FORMDEF command 192 
OPERATION 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION CORNER 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION CUT 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION EDGE 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION FOLD 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION PERFORATE 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION PUNCH 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION SADDLE 

for COPYGROUP command 175 

for FORMDEF command 191 
OPERATION ZFOLD 

for COPYGROUP command 175 
OPOFFSET 

for COPYGROUP command 177 
OPOFFSET n 

for FORMDEF command 192 
OPPOS 

for COPYGROUP command 176 
OPPOS n 

for FORMDEF command 192 
REFERENCE 

for COPYGROUP command 176 

for FORMDEF command 191 
REFERENCE BOTLEFT 

for COPYGROUP command 176 

for FORMDEF command 191 
REFERENCE BOTRIGHT 

for COPYGROUP command 176 

for FORMDEF command 191 
REFERENCE BOTTOM 

for COPYGROUP command 176 

for FORMDEF command 192 
REFERENCE DEFAULT 

for COPYGROUP command 176 

for FORMDEF command 191 
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FINISH subcommand (continued) 
REFERENCE LEFT 
for COPYGROUP command 176 
for FORMDEF command 192 
REFERENCE RIGHT 
for COPYGROUP command 176 
for FORMDEF command 192 
REFERENCE TOP 
for COPYGROUP command 176 
for FORMDEF command 192 
REFERENCE TOPLEFT 
for COPYGROUP command 176 
for FORMDEF command 191 
REFERENCE TOPRIGHT 
for FORMDEF command 191 
SCOPE 
for COPYGROUP command 174 
for FORMDEF command 190 
SCOPE n 
for FORMDEF command 191 
SCOPE ALL 
for FORMDEF command 191 
SCOPE BEGCOLL 
for COPYGROUP command 174 
SCOPE CONTCOLL 
for COPYGROUP command 175 
SCOPE MEDIUM 
for COPYGROUP command 174 
SCOPE PAGE 
for COPYGROUP command 174 
SCOPE PRINTFILE 
for FORMDEF command 190 
finishing operation implementation notes 
FINISH subcommand 
with COPYGROUP command 178 
finishing operation nesting rules 
FINISH subcommand 
with COPYGROUP command 178 
FIRST 
WHEN subcommand 
for CONDITION command (record format) 
for CONDITION command (XML) 268 
FIRST (copygroup) 
WHEN subcommand 
for CONDITION command (traditional) 212 
FIRST (pageformat) 
WHEN subcommand 
for CONDITION command (traditional) 213 
first line of data 
positioning 37 
FIT, OBMAP 
OBJECT subcommand 
for PRINTLINE command (traditional) 254 
for XLAYOUT command (XML) 359 
FIT, OBSIZE 
OBJECT subcommand 
for LAYOUT command (record format) 330 
fixed text 
example 112 
in page definition 112 


FLASH subcommand 
for SUBGROUP command 202 
NO 
for SUBGROUP command 202 
YES 
for SUBGROUP command 202 
FLDNUM 
for FIELD command (XML) 303 
FLDNUM n, VARIABLE 
OBJECT subcommand 
for LAYOUT command (record format) 329 
OVERLAY subcommand 
for LAYOUT command (record format) 334 
SEGMENT subcommand 
for LAYOUT command (record format) 335 
FLDNUM subcommand 
for CONDITION command (record format) 266 
for CONDITION command (XML) 266 
for FIELD command (record format) 288 
FNC1IND, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 298 
for FIELD command (traditional) 230 
for FIELD command (XML) 315 
FNC1UCC, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 298 
for FIELD command (traditional) 230 
for FIELD command (XML) 315 
FOLD, OPERATION 
FINISH subcommand 
for COPYGROUP command 175 
for FORMDEF command 191 
FONT name subcommand 
for TRCREF command (traditional) 261 
FONT command 
example 48, 53, 75, 77 
rotating fonts 53, 77 
FONT command (record format) 
cfname 317 
character-set-name 318 
code-page-name 318 
hex-grid 318 
Iname 317 
‘cfhame 317 
DBCS subcommand 318 
HEIGHT nsubcommand 318 
HEIGHT subcommand 
CM 318 
IN 318 
MM 318 
PELS 318 
POINTS 318 
RATIO subcommand 318 
RECID subcommand 288 
RESOLUTION subcommand 
METRICTECHNOLOGY 319 
METTECH 319 
RES 319 
RESOLUTION 319 
ROTATION subcommand 318 


FONT command (record format) (continued) 
SBCS subcommand 318 
subcommands 318 
syntax diagram 317 
TYPE subcommand 318 

percent 318 
ASCII 318 
EBCDIC 318 
UNICODE 318 

FONT command (traditional) 
cfname 232 
character-set-name 233 
code-page-name 233 
hex-grid 233 
Iname 232 
‘cfhame’ 232 
DBCS subcommand 233 
HEIGHT nsubcommand 233 
HEIGHT subcommand 

ASCII 233 
CM 233 
EBCDIC 233 
IN 233 
MM 233 
PELS 233 
POINTS 233 
UNICODE 233 
RATIO subcommand 233 
percent 233 
RESOLUTION subcommand 234 
METRICTECHNOLOGY 234 
METTECH 234 
RES 234 
RESOLUTION 234 
ROTATION subcommand 234 
SBCS subcommand 233 
subcommands 233 
syntax diagram 232 
TYPE subcommand 233 

FONT command (XML) 
cfname 321 
character-set-name 321 
code-page-name 321 
hex-grid 321 
Iname 321 
‘cfhame’ 321 
DBCS subcommand 321 
HEIGHT nsubcommand 321 
HEIGHT subcommand 

CM 321 
IN 321 
MM 322 
PELS 322 
POINTS 321 
RATIO subcommand 322 
percent 322 
RESOLUTION subcommand 322 
METRICTECHNOLOGY 322 
METTECH 322 
RES 322 
RESOLUTION 322 
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FONT command (XML) (continued) 


ROTATION subcommand 322 
SBCS subcommand 321 
subcommands 321 
syntax diagram 320 
TYPE subcommand 322 
ASCIl 322 
EBCDIC 322 
UNICODE 322 


FONT subcommand 


name1 
for FIELD command (traditional) 220 
for LAYOUT command (record format) 326 
for PRINTLINE command (traditional) 245 
for XLAYOUT command (XML) 356 
name2 
for FIELD command (traditional) 220 
for LAYOUT command (record format) 326 
for PRINTLINE command (traditional) 246 
for XLAYOUT command (XML) 356 
example 53, 78 
for FIELD command (traditional) 220 
for FIELD command (XML) 303 
for LAYOUT command (record format) 326 
for PRINTLINE command (traditional) 245 
for XLAYOUT command (XML) 356 
rotating data 53, 78 


FONTFID subcommand 


for FORMDEF command 192 
NO 

for FORMDEF command 193 
YES 

for FORMDEF command 193 


fonts 


bounded-box 9 
double-byte 220 
in tate presentation 54, 78 
naming in a page definition 48, 75 
rotation of 53, 77 
SOSI 220 
specified 

for field 220 

for PRINTLINE Command 50 
unbounded-box 9 
varying onapage 48, 75 


for FIELD command (XML) 313 
form definition 


command nesting 20 
command reference 169 
contents of 4 
copy groups in 19 
COPYGROUP command 170 
defining overlays 23 
description 4 
duplex printing 

using NORMAL 27 

using RTUMBLE 28 

using subgroups 25 

using TUMBLE 28 
example command streams 19 
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form definition (continued) 
examples 
asymmetric pages 158 
normal duplex 149 
tumble duplex 150 
using CONSTANT and OVERLAY 156 
using INVOKE and OVERLAY 148 
using PLACE 154 
FORMDEF command 185 
logical pages 21 
OVERLAY command 200 
page definition 3 
print jobs requiring 5 
sequence of commands for 169 
SETUNITS command 201 
specifying print quality 
for COPYGROUP command 180 
specifying the N_UP subcommand 146 
steps for creating 3 
storage location 3 
SUBGROUP command 202 
SUPPRESSION command 205 
using commands 19 
formatting multiple applications pages 
onasingle sheet 160 
FORMDEF command 
name 186 
ADJUST nsubcommand 186 
BIN subcommand 187 
n 187 
COMPID m_ 187 
ENVELOPE 187 
MANUAL 187 
MEDIANAME_ 187 
BINERROR subcommand 187 
CONTINUE 187 
STOP 187 
COLORVALUERR subcommand 188 
CONTINUE 188 
CONTINUE NOREPORT 188 
CONTINUE REPORT 188 
STOP 188 
COMMENT subcommand 189 
CONSTANT subcommand 189 
BACK 189 
BOTH 189 
FRONT 189 
NO 189 
CUTSHEET subcommand 189 
NO 189 
YES 189 
DIRECTION subcommand 189 
ACROSS 189 
DOWN 190 
DUPLEX subcommand 190 
NO 190 
NORMAL 190 
RNORMAL_ 190 
RTUMBLE 190 
TUMBLE 190 
FINISH subcommand 190 


FORMDEF command (continued) 
OPCOUNT n 192 
OPERATION 191 
OPERATION CORNER 191 
OPERATION CUT 191 
OPERATION EDGE 191 
OPERATION FOLD 191 
OPERATION PERFORATE 191 
OPERATION PUNCH 191 
OPERATION SADDLE 191 
OPOFFSET n_ 192 
OPPOS n 192 
REFERENCE 191 
REFERENCE BOTLEFT 191 
REFERENCE BOTRIGHT 191 
REFERENCE BOTTOM 192 
REFERENCE DEFAULT 191 
REFERENCE LEFT 192 
REFERENCE RIGHT 192 
REFERENCE TOP 192 
REFERENCE TOPLEFT 191 
REFERENCE TOPRIGHT 191 
SCOPE 190 
SCOPE n 191 
SCOPE ALL 191 
SCOPE PRINTFILE 190 

FONTFID subcommand 192 
NO 193 
YES 193 

INVOKE subcommand 193 
BACK 194 
FRONT 194 
NEXT 193 
SHEET 193 

JOG subcommand 194 
NO 194 
YES 194 

N_UP subcommand 196 
OVERLAY name 196 
OVERLAY x-pos 196 
OVERLAY y-pos 196 
OVERLAY OVROTATE 197 
PLACE 197 
PLACE n_ 197 
PLACE BACK 197 
PLACE CONSTANT 197 
PLACE FRONT 197 
PLACE OFFSET rel-x 197 
PLACE OFFSET rel-y 197 
PLACE OVERLAY name 198 
PLACE OVERLAY rel-x 198 
PLACE OVERLAY rel-y 198 
PLACE OVROTATE 198 
PLACE PARTITION 198 
PLACE ROTATION 198 
PLACE VIEW NO 199 
PLACE VIEW YES 198 

OFFSET subcommand 194 
rel-x 194 
rel-y 194 

OUTBIN nsubcommand 194 


FORMDEF command (continued) 
PELSPERINCH nsubcommand 195 
PRESENT subcommand 195 

LANDSCAPE 195 
PORTRAIT 195 
PROCESSING subcommand 196 
CUT 196 
MEDIA_INFO n_ 196 
PERFORATE 196 
QUALITY nsubcommand 195 
REPLACE subcommand 196 
NO 196 
YES 196 
subcommands' 186 
syntax diagram 185 
TONERSAVER subcommand 188 
VFYSETUP subcommand 
verificationID 199 

FORMDEF Command 
specifying DIRECTION DOWN 31 
specifying the N_UP subcommand 

basic N_UP printing 146 
enhanced N_UP printing 152 

FORMDEF Parameters 
PPFA system dependencies 370 
VM_ 370 

FORMDF parameter 
OS/400 375 

FORMDF restrictions 
OS/400 385 

FRONT 
CONSTANT subcommand 

for COPYGROUP command 173 

for FORMDEF command 189 
INVOKE subcommand 

for COPYGROUP command 179 

for FORMDEF command 194 

FRONT subcommand 
duplexing pages 25 
for SUBGROUP command 203 
rules 26 

FRONT, PLACE 
N_UP subcommand 

for COPYGROUP command 182 
for FORMDEF command 197 
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Glossary Section 461 
References 461 
Source Identifiers 461 
Terms 461 

GOCA 
OBTYPE subcommand 


for OBJECT command (record format) 
for OBJECT command (traditional) 236 


for OBJECT command (XML) 337 
GOCA, OBCOLOR 
OBJECT subcommand 


for LAYOUT command (record format) 


GOCA, OBTYPE 
OBJECT subcommand 
for PRINTLINE command (traditional) 256 
graphical objects subcommand 
LAYOUT (record format) Command 66 
PAGEDEF (record format) Command 66 
GRAPHID subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 284 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 284 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command (XML) 277 
Group Headers 
LAYOUT Command 63 
GROUP subcommand 
for LAYOUT command (record format) 324 
for XLAYOUT command (XML) 354 
GRPHEADER subcommand 
CONTINUE 
for XLAYOUT command (XML) 354 
for LAYOUT command (record format) 324 
for XLAYOUT command (XML) 354 
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HEIGHT 
BARCODE subcommand 
for FIELD command (record format) 295 
HEIGHT n 
BARCODE subcommand 
for FIELD command (record format) 295 
for FIELD command (traditional) 227 
for FIELD command (XML) 311 
HEIGHT n subcommand 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 321 
HEIGHT unit 
BARCODE subcommand 
for FIELD command (record format) 295 
for FIELD command (traditional) 227 
for FIELD command (XML) 311 
HEIGHT subcommand 
n 
for PAGEDEF command (record format) 341 
for PAGEDEF command (traditional) 239 
for PAGEDEF command (XML) 341 
for PAGEFORMAT command (record 
format) 346 
for PAGEFORMAT command (traditional) 242 
for PAGEFORMAT command (XML) 346 
unit 
for PAGEDEF command (record format) 341 
for PAGEDEF command (traditional) 239 
for PAGEDEF command (XML) 341 
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HEIGHT subcommand (continued) 
unit (continued) 
for PAGEFORMAT command (record 
format) 346 
for PAGEFORMAT command (traditional) 242 
for PAGEFORMAT command (XML) 346 
ACROSS 
for PAGEDEF command (record format) 341 
for PAGEDEF command (XML) 341 
ASCII 
for FONT command (traditional) 233 
BACK 
for PAGEDEF command (record format) 341 
for PAGEDEF command (XML) 341 
CM 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 321 
DOWN 
for PAGEDEF command (record format) 341 
for PAGEDEF command (XML) 341 
EBCDIC 
for FONT command (traditional) 233 
example 36, 68 
for PAGEDEF command (record format) 341 
for PAGEDEF command (traditional) 239 
for PAGEDEF command (XML) 341 
for PAGEFORMAT command (record format) 346 
for PAGEFORMAT command (traditional) 242 
for PAGEFORMAT command (XML) 346 
IN 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 321 
MM 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 322 
PELS 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 322 
POINTS 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 321 
UNICODE 
for FONT command (traditional) 233 
UP 
for PAGEDEF command (record format) 341 
for PAGEDEF command (XML) 341 
hexadecimal codes (type X text) 
for FIELD command (record format) 287 
for FIELD command (traditional) 219 
for FIELD command (XML) 302 
HIGHLIGHT 
color model 
for FIELD command (record format) 290 
for FIELD command (traditional) 222 
for FIELD command (XML) 306 
for PRINTLINE command (traditional) 251 


HIGHLIGHT hAvalue 
COLOR subcommand 
for DEFINE COLOR command (record 
format) 271 
for DEFINE COLOR command (traditional) 215 
for DEFINE COLOR command (XML) 271 
highlight color 
naming in a page definition 47 
HIGHLIGHT command 
example 47 
HIGHLIGHT subcommand 
for FIELD command (record format) 
hvalue 290 
for FIELD command (traditional) 
hvalue 222 
for FIELD command (XML) 
hvalue 306 
for PRINTLINE command (traditional) 
hvalue 251 
HRI 
BARCODE subcommand 
for FIELD command (record format) 294 
HRI fontname 
BARCODE subcommand 
for FIELD command (record format) 295 
HRI ABOVE 
BARCODE subcommand 
for FIELD command (record format) 294 
for FIELD command (traditional) 226 
for FIELD command (XML) 310 
HRI BELOW 
BARCODE subcommand 
for FIELD command (record format) 294 
for FIELD command (traditional) 226 
for FIELD command (XML) 310 
HRI OFF 
BARCODE subcommand 
for FIELD command (record format) 294 
for FIELD command (traditional) 226 
for FIELD command (XML) 310 
HRI ON 
BARCODE subcommand 
for FIELD command (record format) 294 
for FIELD command (traditional) 226 
for FIELD command (XML) 310 
HRI ONLY 
BARCODE subcommand 
for FIELD command (traditional) 226 
for FIELD command (XML) 310 
HRIFONT fontname 
BARCODE subcommand 
for FIELD command (traditional) 226 
for FIELD command (XML) 311 


IBM 3800 Printing Subsystem 
coexistence with IBM continuous forms printers 32 
migration 32 

IBM 3900 Printing Subsystem 
restrictions on printing area of sheet 21 


IBM continuous forms printers 
coexistence with the IBM 3800 Printing 
Subsystem 32 
specifying page presentation for 30 
ID uidHi, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 296 
for FIELD command (traditional) 228 
for FIELD command (XML) 313 
ID uidLo, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 296 
for FIELD command (traditional) 228 
for FIELD command (XML) 313 
IDM structured field 
and the PAGEFORMAT command (traditional) 242 
for PAGEFORMAT command (record format) 345 
for PAGEFORMAT command (XML) 345 
IGC parameters 
OS/400 383 
IN 
HEIGHT subcommand 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 321 
IN, unit 
LINESP subcommand 
for SETUNITS command (traditional) 260 
IND2OF5, TYPE 
BARCODE subcommand 
for FIELD command (record format) 292 
for FIELD command (traditional) 224 
for FIELD command (XML) 308 
Industrial 2-of-5 395, 396, 402, 404 
inline direction 
description 8 
specified in page definition 
for FIELD command (XML) 305 
Interleaved 2-of-5 395, 397, 402, 404 
INVMMAP (medium-map-name) DDS keyword 
OS/400 384 
Invoke Data Map (IDM) structured field 
and the PAGEFORMAT command (traditional) 242 
for PAGEFORMAT command (record format) 345 
for PAGEFORMAT command (XML) 345 
INVOKE subcommand 
BACK 
for COPYGROUP command 179 
for FORMDEF command 194 
basic N_UP printing example 148 
for COPYGROUP command 178 
for FORMDEF command 193 
FRONT 
for COPYGROUP command 179 
for FORMDEF command 194 
NEXT 
for COPYGROUP command 179 
for FORMDEF command 193 
SHEET 
for COPYGROUP command 179 
for FORMDEF command 193 
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IOCA 
OBTYPE subcommand 
for OBJECT command (record format) 337 
for OBJECT command (traditional) 236 
for OBJECT command (XML) 337 
IOCA, OBCOLOR 
OBJECT subcommand 
for LAYOUT command (record format) 332 
IOCA, OBTYPE 
OBJECT subcommand 
for PRINTLINE command (traditional) 256 
ITL2OF5, TYPE 
BARCODE subcommand 
for FIELD command (record format) 292 
for FIELD command (traditional) 224 
for FIELD command (XML) 308 


J 


job control language (JCL) for OS/390 368 
job control statements (JCS) for VSE 367 
jog (offset stacking), 
conditional processing example 129 
JOG subcommand 
for COPYGROUP command 179 
for FORMDEF command 194 
NO 
for COPYGROUP command 179 
for FORMDEF command 194 
YES 
for COPYGROUP command 179 
for FORMDEF command 194 
JPOSTAL 395, 397, 402, 406, 413 
JPOSTAL, TYPE 
BARCODE subcommand 
for FIELD command (record format) 293 
for FIELD command (traditional) 225 
for FIELD command (XML) 309 


K 


kanji numbers (type K text) 
for FIELD command (record format) 287 
for FIELD command (traditional) 219 
for FIELD command (XML) 302 
kanji print presentation 
example 54, 78 


L 
L (m) 
TEXT subcommand 
for FIELD command (record format) 287 
for FIELD command (traditional) 219 
for FIELD command (XML) 302 
LANDSCAPE 
PRESENT subcommand 
for COPYGROUP command 180 
for FORMDEF command 195 
landscape presentation 
description 10 
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landscape presentation (continued) 
specifying on continuous-forms printers 29 
with duplex printing 27 
with OFFSET subcommand 22 
LARGE 
ROUNDED subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 
layout 
description 8 
LAYOUT (record format) Command 
conditional processing considerations 66 
defining color models 67 
graphical objects subcommand 66 
logical page eject processing 66 
PAGE NUMBERING subcommand 66 
record formatting examples 79 
LAYOUT Command 
example 74 
Field (record format) Command 64 
GROUP Headers 63 
in field processing 72 
Page Headers and Trailers 63 
printing direction of 74 
types of Data Records 62 
LAYOUT command (record format) 
‘record ID' subcommand 324 
BODY subcommand 324 
COLOR colorname subcommand 326 
DEFAULT subcommand 324 
DELIMITER subcommand 325 
DIRECTION subcommand 325 
ACROSS 325 
BACK 325 
DOWN 325 
UP 325 
ENDSPACE subcommand 325 
FONT subcommand 326 
name1 326 
name2 326 
GROUP subcommand 324 
GRPHEADER subcommand 324 
NEWPAGE subcommand 325 
OBJECT subcommand 328 
internal-name 328 
relative-xpos 328 
relative-ypos 328 
OBCHPOS 330 
OBCHPOS x-pos 330 
OBCHPOS USEOBJ 330 
OBCOLOR colorname 331 
OBCVPOS 330 
OBCVPOS y-pos 330 
OBCVPOS USEOBJ 331 
OBMAP 329 
OBROTATE 331 
OBSIZE 329 
OBSIZE hg 329 
OBSIZE unit 329 
OBSIZE wd 329 


LAYOUT command (record format) (continued) 
OBJECT subcommand (continued) 
OBSIZE CENTER 330 
OBSIZE FILL 330 
OBSIZE FIT 330 
OBSIZE LEFT 329 
OBSIZE REPEAT 330 
OBSIZE TRIM 330 
OBSIZE USEOBJ 329 
OBTYPE 332 
OBTYPE BCOCA 332 
OBTYPE GOCA 332 
OBTYPE IOCA 332 
OBTYPE OBID 332 
OBTYPE OBID component-id 332 
OBTYPE OBID type-name 332 
OBTYPE OTHER 332 
OBTYPE PSEG 332 
VARIABLE 328 
VARIABLE FLDNUM n 329 
VARIABLE LENGTH n_ 329 
VARIABLE RECID 329 
VARIABLE START n 328 
OVERLAY subcommand 333 
name 333 
relative-xpos 333 
relative-ypos 333 
OVROTATE 334 
VARIABLE 333 
VARIABLE FLDNUM n_ 334 
VARIABLE LENGTH n_ 334 
VARIABLE RECID n 334 
VARIABLE START n 334 
PAGEHEADER subcommand 324 
PAGETRAILER subcommand 325 
POSITION subcommand 326 
PRINTDATA subcommand 326 
horizontal position x-pos 327 
horizontal position = 327 
horizontal position LEFTMARGIN 327 
horizontal position SAME 327 
vertical position 327 
vertical position y-pos 327 
vertical position = 328 
vertical position NEXT 327 
vertical position SAME 328 
vertical position TOPMARGIN 327 
NO 326 
NOhorizontal position 327 
RELATIVE 327 
YES 326 
SEGMENT subcommand 334 
name 334 
relative-xpos 334 
relative-ypos 334 
VARIABLE 334 
VARIABLE FLDNUM n_ 335 
VARIABLE LENGTH n_ 335 
VARIABLE RECID n 335 
VARIABLE START n 334 
subcommands 324 


LAYOUT command (record format) (continued) 
syntax diagram 323 
XSPACE subcommand 324 
LAYOUT Commands 
in page definition 62 
LEFT 
ALIGN subcommand 
for FIELD command (record format) 288 
for FIELD command (XML) 304 
LEFT, OBMAP 
OBJECT subcommand 
for PRINTLINE command (traditional) 254 
for XLAYOUT command (XML) 359 
LEFT, OBSIZE 
OBJECT subcommand 
for LAYOUT command (record format) 329 
LEFT, REFERENCE 
FINISH subcommand 
for COPYGROUP command 176 
for FORMDEF command 192 
LEFTMARGIN subcommand 
for PAGEDEF command (record format) 343 
for PAGEDEF command (XML) 343 
for PAGEFORMAT command (record format) 347 
for PAGEFORMAT command (XML) 347 
LEFTMARGIN, horizontal position 
POSITION subcommand 
for XLAYOUT command (XML) 356 
PRINTDATA subcommand 
for LAYOUT command (record format) 327 
LENGTH n 
ATTR subcommand 
for FIELD command (XML) 303 
LENGTH n subcommand 
for CONDITION command (record format) 266 
for CONDITION command (traditional) 210 
for CONDITION command (XML) 266 
for FIELD command (record format) 287 
for FIELD command (traditional) 219 
for FIELD command (XML) 302 
LENGTH n, VARIABLE 
OBJECT subcommand 
for LAYOUT command (record format) 329 
for PRINTLINE command (traditional) 253 
OVERLAY subcommand 
for LAYOUT command (record format) 334 
for PRINTLINE command (traditional) 249 
SEGMENT subcommand 
for LAYOUT command (record format) 335 
for PRINTLINE command (traditional) 250 
library-resource name 
description 23 
LIGHT 
LINEWT subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
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LIGHT (continued) 
LINEWT subcommand (continued) 


for DRAWGRAPHIC - ELLIPSE command (record 


format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
LINE 
REPEAT subcommand 
for PRINTLINE command (traditional) 245 
WHEN subcommand 
for CONDITION command (record format) 267 
for CONDITION command (traditional) 211 
for CONDITION command (XML) 267 
line data 
description 6 
printing, print server printer 40 
record format 6 
structured fields 12 
traditional 6 
line data processing 
versus conditional processing 117 
LINEONE subcommand 
X-pos 
for PAGEDEF command (traditional) 240 
for PAGEFORMAT command (traditional) 243 
y-pos 
for PAGEDEF command (traditional) 240 
for PAGEFORMAT command (traditional) 243 
example 37 
for PAGEDEF command (traditional) 240 
for PAGEFORMAT command (traditional) 243 
positioning first line of data 37 
lines, printing 
in two directions 51, 74 
LINESP nsubcommand 
for SETUNITS command 201 
LINESP subcommand 
n 
for PAGEFORMAT command (record 
format) 349 
for PAGEFORMAT command (XML) 349 
for SETUNITS command (traditional) 260 
nall others 
for SETUNITS command (traditional) 260 
nLPl 
for SETUNITS command (traditional) 260 
unit 
for PAGEFORMAT command (record 
format) 349 
for PAGEFORMAT command (XML) 349 
for SETUNITS command (traditional) 260 
unit CM 
for SETUNITS command (traditional) 260 
unit IN 
for SETUNITS command (traditional) 260 
unit LPI 
for SETUNITS command (traditional) 260 
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LINESP subcommand (continued) 


unit MM 

for SETUNITS command (traditional) 260 
unit PELS 

for SETUNITS command (traditional) 260 
unit POINTS 

for SETUNITS command (traditional) 260 
for SETUNITS command (record format) 349 
for SETUNITS command (traditional) 259 
for SETUNITS command (XML) 349 
positioning the first line of data 38 


LINETYPE subcommand 


DASHDOT 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
DBLDOT 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
DOTTED 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
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DSHDBLDOT 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command (XML) 277 
LONGDASH 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
SHORTDASH 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
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SHORTDASH (continued) 
for DRAWGRAPHIC - LINE command 
(XML) 277 
SOLID 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 


LINEWT subcommand 


BOLD 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command (XML) 277 
LIGHT 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
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LINEWT subcommand (continued) 
LIGHT (continued) 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
MEDIUM 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
literals 
description 166 
syntax 166 
used in TEXT subcommand 166 
used in WHEN subcommand 166 
local name 
description 23 
logical page 
defining size 36, 68 
description 7 
positioning 21 
size 36, 68 
specifying the origin 21 
logical page eject processing 
LAYOUT (record format) Command 66 
PAGEDEF (record format) Command 66 
LONGDASH 
LINETYPE subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
LPI, unit 
LINESP subcommand 
for SETUNITS command (traditional) 260 
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LPOS subcommand 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 284 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 284 


M 


MAC5, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 298 
for FIELD command (traditional) 230 
for FIELD command (XML) 315 
MAC6, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 298 
for FIELD command (traditional) 230 
for FIELD command (XML) 315 
MACRO, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 298 
for FIELD command (traditional) 231 
for FIELD command (XML) 315 
MANUAL 
BIN subcommand 
for COPYGROUP command 172 
for FORMDEF command 187 
for SUBGROUP command 203 
MAT2OF5, TYPE 
BARCODE subcommand 
for FIELD command (record format) 292 
for FIELD command (traditional) 224 
for FIELD command (XML) 308 
Matrix 2-of-5 395, 396, 402, 404 
MAX 
ROUNDED subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
measurement 
differences in repeated lines 393 
units, described 166 
MEDIA_INFO n 
PROCESSING subcommand 
for COPYGROUP command 181 
for FORMDEF command 196 
MEDIANAME 
BIN subcommand 
for FORMDEF command 187 
for SUBGROUP command 204 
MEDIANAME string 
BIN subcommand 
for COPYGROUP command 172 
MEDIUM 
LINEWT subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
for DRAWGRAPHIC - CIRCLE command (record 
format) 279 


MEDIUM (continued) 
LINEWT subcommand (continued) 
for DRAWGRAPHIC - CIRCLE command 
(XML) 279 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 282 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 282 
for DRAWGRAPHIC - LINE command (record 
format) 277 
for DRAWGRAPHIC - LINE command 
(XML) 277 
ROUNDED subcommand 
for DRAWGRAPHIC - BOX command (record 
format) 274 
for DRAWGRAPHIC - BOX command (XML) 274 
medium map 
description 13 
invoke 13 
medium overlay 
description 159 
using with NUP 159 
MEDIUM, SCOPE 
FINISH subcommand 
for COPYGROUP command 174 
messages and codes 439 
METRICTECHNOLOGY 
RESOLUTION subcommand 
for FONT command (record format) 319 
for FONT command (traditional) 234 
for FONT command (XML) 322 
METTECH 
RESOLUTION subcommand 
for FONT command (record format) 319 
for FONT command (traditional) 234 
for FONT command (XML) 322 
MIN, BCXPARMS SIZE 
BARCODE subcommand 
for FIELD command (record format) 296 
for FIELD command (traditional) 228 
for FIELD command (XML) 312 
mixed data 
description 7 
MM 
HEIGHT subcommand 
for FONT command (record format) 318 
for FONT command (traditional) 233 
for FONT command (XML) 322 
MM, unit 
LINESP subcommand 
for SETUNITS command (traditional) 260 
MO:DCA-P data 
description 7 
MOD n 
BARCODE subcommand 
for FIELD command (record format) 294 
for FIELD command (traditional) 225 
for FIELD command (XML) 310 
MOD parameter 
bar code type 401 
MOD value 401 


MODE, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 298 
for FIELD command (traditional) 230 
for FIELD command (XML) 314 
modifications 
description 10 
MODWIDTH n 
BARCODE subcommand 
for FIELD command (record format) 295 
for FIELD command (XML) 311 
MODWIDTH unit 
BARCODE subcommand 
for FIELD command (traditional) 227 
MSI 395, 396, 402 
MSI, TYPE 
BARCODE subcommand 
for FIELD command (record format) 292 
for FIELD command (traditional) 223 
for FIELD command (XML) 308 
multiple conditions, conditional processing 
examples 132 
multiple-up printing 
compared to N_UP printing 8, 160 
conditional processing 120 
description 55 
example 55 


N 


N_UP partitions 
arrangement 141 
description 10, 141 
N_UP printing 
basic description 141 
basic N_UP printing 141 
compared to multiple-up printing 8, 160 
enhanced N_UP printing 141 
examples 
asymmetric pages 157 
normal duplex 149 
tumble duplex 150 
using CONSTANT and OVERLAY 155 
using INVOKE and OVERLAY 148 
using PLACE 154 
list of printers 141 
partition arrangement 141 
partitions 141 
N_UP subcommand 
basic N_UP printing 146 
for COPYGROUP command 181 
for FORMDEF command 196 
in COPYGROUP Command 146, 153 
in FORMDEF Command 146, 152 
OVERLAY name 
for COPYGROUP command 181 
for FORMDEF command 196 
OVERLAY x-pos 
for COPYGROUP command 181 
for FORMDEF command 196 
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N_UP subcommand (continued) 


OVERLAY y-pos 

for COPYGROUP command 181 

for FORMDEF command 196 
OVERLAY OVROTATE 

for COPYGROUP command 182 

for FORMDEF command 197 
OVERLAY PARTITION 

for COPYGROUP command 181 
PLACE 

for FORMDEF command 197 
PLACE n 

for COPYGROUP command 182 

for FORMDEF command 197 
PLACE BACK 

for COPYGROUP command 182 

for FORMDEF command 197 
PLACE CONSTANT 

for COPYGROUP command 182 

for FORMDEF command 197 
PLACE FRONT 

for COPYGROUP command 182 

for FORMDEF command 197 
PLACE OFFSET 

for COPYGROUP command 182 
PLACE OFFSET rel-x 

for FORMDEF command 197 
PLACE OFFSET rel-y 

for FORMDEF command 197 
PLACE OVERLAY 

for COPYGROUP command 183 
PLACE OVERLAY name 

for FORMDEF command 198 
PLACE OVERLAY rel-x 

for FORMDEF command 198 
PLACE OVERLAY rel-y 

for FORMDEF command 198 
PLACE OVERLAY x-pos y-pos 

for COPYGROUP command 183 
PLACE OVERLAY OVROTATE 

for COPYGROUP command 183 
PLACE OVERLAY PARTITION 

for COPYGROUP command 183 
PLACE OVROTATE 

for FORMDEF command 198 
PLACE PARTITION 

for FORMDEF command 198 
PLACE ROTATION 

for COPYGROUP command 183 

for FORMDEF command 198 
PLACE VIEW 

for COPYGROUP command 184 
PLACE VIEW NO 

for COPYGROUP command 184 

for FORMDEF command 199 
PLACE VIEW YES 

for COPYGROUP command 184 

for FORMDEF command 198 


names 


character length allowed 165 
library-resource 23 
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names (continued) 
local 23 
overlay 23 
resource 23 
user-access 23 
NAMES in PPFA 165 
narrow forms 
definition 30 
nesting rules 
commands 
form definition 20 
page definition 36 
nesting rules, finishing operation 
FINISH subcommand 
with COPYGROUP command 178 
NEWFORM 
WHEN subcommand 
for CONDITION command (record format) 267 
for CONDITION command (traditional) 211 
for CONDITION command (XML) 267 
NEWFORM parameter 
using with enhanced N_UP_ 159 
NEWPAGE subcommand 
for LAYOUT command (record format) 325 
for XLAYOUT command (XML) 355 
NEWSIDE 
WHEN subcommand 
for CONDITION command (record format) 267 
for CONDITION command (traditional) 211 
for CONDITION command (XML) 267 
NEWSIDE parameter 
using with enhanced N_UP 159 
NEXT 
INVOKE subcommand 
for COPYGROUP command 179 
for FORMDEF command 193 
WHEN subcommand 
for CONDITION command (record format) 268 
for CONDITION command (XML) 268 
NEXT (copygroup) 
WHEN subcommand 
for CONDITION command (traditional) 212 
NEXT (pageformat) 
WHEN subcommand 
for CONDITION command (traditional) 213 
NEXT subcommand 
for DRAWGRAPHIC - ELLIPSE command (record 
format) 284 
for DRAWGRAPHIC - ELLIPSE command 
(XML) 284 
NEXT, vertical position 
POSITION subcommand 
for XLAYOUT command (XML) 357 
PRINTDATA subcommand 
for LAYOUT command (record format) 327 
NO 
CONSTANT subcommand 
for COPYGROUP command 173 
for FORMDEF command 189 
CUTSHEET subcommand 
for COPYGROUP command 173 


NO (continued) 
CUTSHEET subcommand (continued) 
for FORMDEF command 189 
DUPLEX subcommand 
for COPYGROUP command 174 
for FORMDEF command 190 
FLASH subcommand 
for SUBGROUP command 202 
FONTFID subcommand 
for FORMDEF command 193 
INVOKE subcommand 
for COPYGROUP command 179 
JOG subcommand 
for FORMDEF command 194 
PRINTDATA subcommand 
for LAYOUT command (record format) 326 
for PRINTLINE command (traditional) 246 
for XLAYOUT command (XML) 356 
REPLACE subcommand 
for FORMDEF command 196 
for PAGEDEF command (record format) 342 
for PAGEDEF command (traditional) 240 
for PAGEDEF command (XML) 342 
SPACE_THEN_PRINT subcommand 
for CONDITION command (traditional) 210 
No Operation (NOP) 13 
NO, PLACE VIEW 
N_UP subcommand 
for FORMDEF command 199 
NOE2A, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 297 
for FIELD command (traditional) 229 
for FIELD command (XML) 314 
NOESC, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 297 
for FIELD command (traditional) 229 
for FIELD command (XML) 314 
NOPRELOAD 
OBKEEP subcommand 
for OBJECT command (record format) 338 
for OBJECT command (traditional) 237 
for OBJECT command (XML) 338 
NOPRELOAD subcommand 
for OBJECT command (record format) 338 
for OBJECT command (traditional) 237 
for OBJECT command (XML) 338 
for OVERLAY command (record format) 339 
for OVERLAY command (traditional) 238 
for OVERLAY command (XML) 339 
NORASTER subcommand 
for OVERLAY command 200 
NOREPORT, CONTINUE 
COLORVALUERR subcommand 
for FORMDEF command 188 
NORMAL 
DUPLEX subcommand 
for COPYGROUP command 174 
for FORMDEF command 190 


normal duplex 
definition 13 
example 149 
normal line data processing 
versus conditional processing 117 
NORMAL parameter 
description 27 
notices 457 
Notices section 457 
NOZIPPER, BCXPARMS 
BARCODE subcommand 
for FIELD command (record format) 298 
for FIELD command (traditional) 230 
for FIELD command (XML) 315 
NULL or / 
WHEN subcommand 
for CONDITION command (record format) 268 
for CONDITION command (XML) 268 
NULL or / (copygroup) 
WHEN subcommand 
for CONDITION command (traditional) 212 
NULL or / (pageformat) 
WHEN subcommand 
for CONDITION command (traditional) 213 
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